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Visual Java Development 


Build Rome in a day. 

It’s easy with Symantec 
Visual Cafe" for Java: 



► 


Visual Caf6 for Macintosh'and Windowsr 




*T affe Develop faster. Compile 

fester Debug fester Realize 
your Java"^ dreams faster. 

Symantec, the creator of 
the first full-featured Java 
development environment, now unleashes 
the first Rapid Application Development 
environment for Java developers: 

Symantec Visual Cafe!” 



Visual Cafd comes complete with an 
extensible component library with all of the 
building blocks you need for your application. 

Simply drag and drop a component 
onto a form. Our Interaction Wizard 
lets you visually specify all the actions 
and events. And then Visual Cafe 
automatically ger>erates the Java 
code for you. 

Thanks to our exclusive two-way 
programming you can add or modify 
the code at the source level, loo. 

So you'll be whipping out those 
application prototypes at speeds 
you can only dream of now. 

Imagine building all of your forms 
visually. Or building your entire user interface 
without writing one single line of code! 

As an added bonus. Symantec's Just In 
Time urn compiler (included in Netscapes 
new Navigator'”) runs your Java applications 
faster than any other browser or Java 
virtual machine on the planet. 



So get your hands on the hottest new 
development tool For Java right away. 


For more information, calf us at 
!-800-453‘t 059 ext. 9H32 or visit our 
Web site at cafe.Symantec.com. Or 
pick up a copy at your local reselfer. 


SYMANTEC. 


Symanlec Is o registened ItTHterivirk and Visual Cafi la a trademark erf Symantec Cwporatmn. Java bi a iradamark o( Sui i Micr&syslems. Inc Microsoft. Wlndo»A<s ond the Widows logo nro 
registered tradeniarks d Micrtreofl Corjjoraiigo. MBDntosh is 3 resisEened trsdemafk, and the Macintosh OS logo is a IrKtengrk of Afjple Computer Inc., used urder Jiperise. Netscaptf htevijjatof 
IS a Lradernark u( N'etscaps Corporation, All olKer brand rtainies or trademadta are property of thfilr raspccUve owrere. ©1997 Symartec Corporahon. All nylds rusarved, Irr Canada, cafi 
1 ■a00-36&'8841, hi Ausirallo, coll EK-SeSO-lOOO In Europe, 3r7l-535^3V11. 












































‘TVi/Aowf a doubty the Premiere Resource Editor 
for the Mac OS A wealth of time-saving tools. 

- MacUser Magazine Eddy Awards 

"A distinct improvement over Apple's ResEdlL 
- Maclkch Magazine 

“Every Mac OS developer shimld own a copy of Rcsorcerer. 

— Leonard Rosenthof Aladdin Systems 

"Without Resorcerer^ our localization efforts would look like, a 
Tower ofBabeL Don't do product without itf" 

- Greg Galanas, CEO and President, Metrowerks 

“Resorcerer^s data template system is amazingf 

- Bill Goodman, author of Smaller Installer and Compact Pro 


“Resorcerer Rocks! Buy it, you will NOT regret U. ” 

- Joe Zobkiw, author of A Fragment of Your Imagination 

“Resorcerer will pay for itself many times over in saved time and efforL"" 
— MacUser review 

“The template that disassembles PlCTs is awesomer 

- Bill Steinberg, author ofPyro! and PBTools 

“Resorccrer proved indispensible in its own creationr 
“ Doug McKenna, author of Resorcerer 





Version 2.0 


ORDERING INFO 


Requires System 7.0 or greater, 
L5MB RAM, CD-ROM 

Standard price: $256 (decimal) 
Website price: $l2ft • $256 
(Educational, quantity, or 
other discounts available) 

Includes: Electronic documentation 
60-day Money-Back Guarantee 
Domestic standard shipping 

Payment: Check, PO's, or Visa/MC 
Taxes: Colorado customers only 

Extras (call, fax, or email us): 

COD, FedEx, UPS BlueTRed, 
International Shipping 

MATHEM^STHETTCS, INC. 

PO Box 298 

Boulder, CO 80306-0298 USA 
Phone: (303) 440^0707 
Fax: (303) 440-0504 
resorcerer@ma the maes thet ics .com 


The Resource Editor for the Mac^^ OS Wizard 


• Very fast, HFS brawscr generically views any file’s contents 

• Extensibility for new Resorcerer Apprentices (CFM plug-ins) 

• AppleScript Dictionary (‘acte’) Apprentice Editor 

• Integrated support for Wemd’ menu commands 

• TextlVaits Editor 

• Complete AIFF sound file disassembly template 

• Big-, little-, and even mixed-endian template parsing 

• HFS folder attribute editing 

• Temporary memory always used everywhere if needed 

• Automattealiy creates *STK#’s by parsing 0/0+4* source 


New 

in 

2 . 0 : 


Easier, faster, more Mac-1 iko, and more productive than ResEdit 
Safer memory-based, not disk-file-based, design and operation 
All file information and common commands in one easy-to-use window 
Compares resource Hies, and even edits your data forks as well 
Visible, accumulating, editable scrap 

Searches and op on s/mark s/s elects resources by text content 
Makes global resource ID or type changes easily and safely 
Builds resource files from simple Rex-like scripts 
Most editors DeRex directly to the clipboard 

All graphic editors support screen-copying or partial screen-copying 
Hot-linking Value Converter for editing 32 hits in a dozen formats 
Its own 32-bit List Mgr can open and edit very large data structures 
Templates can pre- and post-process any arbitrary data structure 
Includes nearly 200 templates for common system resources 
TMPLs for Installer, MacApp, QT, Help, AppleEvcnt, OCE, GX, etc. 
Full integrated support for editing color dialogs and menus 
Try out balloons, 'ietb's, lists and popups, even create C source code 
Integrated single-window Hex/Code Editor, with patching, searching 
Editors for cursors, versions, pictures, bundles, and lots more 
Relied on by thousands of Macintosh developers around the world 


To order by credit card, or to get the latest news, bugfixes, updates, and apprentice^ visit our website... 

www.mathemaesthetics.com 
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How To Communicate With Us 


In tills electronic age^ the an of 
communication has become boili easier and 
more complicated. Ts it any surprise that we 
prefer e-mail? 

If you have any questions, feel free to call us 
at m5/m^9797 or Fax us at 805/49^9798. 

If you would like a subscription or need 
cuslomer service, feel free to contact 
Developer Depot Customer Seivacc at 
80(hMACDCV-l 
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iN lliLUGENT Wt)RKSPA<llS 

Every few montlLS 1 find myself in a situation where 1 Imve 
ro move my workspace to anotlier computer Tile most rec:eni 
CKcurrenee was when 1 sent my powerhook in for rei>air. This 
activity reminded me yet again lujw poorly organized is the 
Mat£).S directory structure. 

l^y workspace 1 mean all the software I use in my work. This 
is pretty much everything on my hard disk, hut it .shtiuldn't Ix". In 
an ideal worlcl I could copy a bimch of idldeni to another cximpiiter 
(t>r just mt)vt.* their hird disk), tell the computer to use tlie newly 
copiexl worksj^ace, and this ixher computer would suddenly Ixhave 
exactly like the one I copied from. Seems sensible, doesn’t it? 

Enier the Real World 

So, why dtx'sn't this work in the real world? Hrst, thert^ is no 
cona^pt ol’ iran-sporttble workspace in the MacOS. Hie workspjHX" ts 
intimalely rial to the System holder of any given Mac. customize 
our workspace l>y adding Control Eanels, lixteasioas and iithcT 
gcxxlicN to a System Folder. To make iiiaiiers wotstr, rhind parry 
software developers customize our workspace lor us hy adding ilieir 
sliared libraries, preference! Hies and otlier items to iJie System Folcler 
One result of all llus is iliat every System Fokktr is unicfue. 

’I he must practical way tu transjxm a workspace to another 
Mac is to ctjpy the System Folder in addition to all the other files, 
hut what if that System Folder is not configured for the new 
hardware? Fvery model Macintosh retfuires special re-sources 
provided by the lastaller. Unless our transjxjrtahle System Folder 
was cretiled to run on every Macintosh, it probably wont run on 
any model other than the one it came fnmi. Network settings are 
specific to a given hardware configuration, too: IF numlx:rs are 
different, as are machine names, and |X>ssibly even neiw'ork 
hardware (Elhernel tjr Ixicxl'nilk?). Hiere are numerous other 
problems that make moving the System Folder dilTiculi; I ml her 
rioi have ro louch it. 

A Better Solution on the Way? 

Imagine having a Workspaev folder where applications can 
store f)references, shared lihnirk^ and other shared resources, all in 
a wdl oig^inized hieranjliy. It would also contain an Hxten.stf^as 
folder where 1 c;in place my favonte .soriwarc^ for tmsiomizing the 
ofXTaLion and appc^aranc'e of my worksp;ice. The System Folder 
would remain untouched by third-part>' software and rentiiin 
specific to the computer liardwanj. 1 could m<we my Workspace 
fokler to any computer, tell that computer which workspace to u,sc\ 
and immediately have all my personal system tweaks. aj>plic*iiioas 
and documents availahie on llie new t:omputer. Such a workspace 
amid even lx* made available over ttie network. 

I>x\s this lx!gin to sound like the user actx>unt system o)' 
NFXI^STFF? NFA^mEF oHers some of the Ixneflts of a tnmsptirtabie 


workspace, but at a high price: the host system must always be 
available to the client com[)uter tlm^ugh ihe network. This 
fe(|uinemcnt is unrealistic tn our mobile computing cnviioniiicnL; we 
just don't have enough bandwicith yet. I'd much rather carry a 
removable hard disk caruidge llian launch my applications through 
an Internet I'-l connection. There also are many limes wlien T have 
to supply my own computer, sti I earry that along as well. 

Making Workspaces a Reality 

How can we n^ake this happen? How can we graft the 
workspace concept onio the existing MatOS? How can we convince 
Afxple to build Woikspaccs into a future OS? Unfortunately, it seems 
everyone and tlteir brexhers insist cm placing their filGi in my System 
Folder. Tlie first step is for software develo|X‘rs to Ixgin using tlie 
MncIFokler API witli folder selecions for ihe Applioation Support, 
Sharc^l libiaries, Preferences, and exher Sfxdal folders, and for 
them to stay cjut of die System F'older, Exteasioas and Contiol Panels 
foidei-s iMi mucli as possi!>le. Ik-irer yet. appiotion developers am 
register tlieir own slKired libraiy folder (and otiiers) with die System 
and use FindFolder to aceexs ii. Iften we aseis can move die 
“s[>ecud'’ folders anyplace we wane 

The next step is lo get Ap(ik* lo build (he concept of workspace" 
into the OS. Fhey already have tnany of the pieces, hul the Apple 
folks IVe spciken with don't .sec* the value of supptxting multiple or 
iraiis|X)italile worksfiates. fm sure anyone who has maaaged 
sharc'd access of many [x-ofile lo a limiietl nunilxT of computers wall 
rec'ognize dte vidue of unique workspaces and kxked System 
Folders. In faa, people in the insTituiional ctjiiimuniiies aa- already 
woiking on Wel>lxtseti solutions to this pn)l>kiii. 

Hie IxmefiLs oJ* workspaces alstr alTccl individual users: 
imagine Ixing able to store your workspatv on a PC C^aid. Want to 
take a few^ dtxuments home from work? (k)py them to your 
workspace^ pull the card fn>in y«Hir iilTice computer, and [)lug it in 
when you gti home. Your iitane computer is immt'diately 
txmvciU’d IVoni your daughter’s coni igumtion to your work 
configuration. Tins ,s;ime mechanism can be u.stxl for sharing 
pfntable computers (or desktops ) in an oft ice envmmment. No 
longer would ptxiple have to sptaid htnirs configuring a new 
machine to meet their needs: they just plug in rht'ir work.sp:ice. 

This whole concept of workspace is just one small step lo 
making computer easier to use. In recent years computers 
have become mucfi more sophisticated, with ever more 
powerful processors and st^ftware to use them, but computers 
have nor really become any easier to use. Many people spend 
several liours each week moving files around and otherwise 
organizing or cleaning up their computer file systems. 
Intelligent w^orkspaces are another tool to help reduce itie 
housekeeping chores of computer users. Now, if only we can 
convince Apple to make it. HQ 
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MORE DEVELOPERS PROTECT. 




MacHASP Packs 
More Into Less. 

liased on state-of-the-art ASIC technology, 
M:icl lASP packs tlie industry's must 
advanced security, compatibility and 
flexibility into a compact and end-user- 
friendly dongle. 


Grow With Aladdin! 

The fastest growing company 
in the industry, widi over 4 
million keys sold to 20 
thousand develo])ers 
worldwide, Aladdin is setting 
the skuidard for software security today. 



NSTL Study Rates 
IIASPNo.1! 

A neceni test conducted by the National 
Software 'Ifesling l.abs\ tlie world's foreniosl 
iiKle[)en(lent lab, compared the fla^hip PC 
products of le:idin^ software protection 
vendors. 'Ilie result? HASf^ was rated tlie clear 
overall winner - and number one in all liie 
major comparison catL^()i1es. For a full co]iy 
of tlie NSTl. report, contaci yotir loc;il 
HASP distributor. 


MacHASP 
PROTECTS 
MORE. £, 


These days, more and more devek>|)ers are choosing to protect their software against 
piracy. They're protecting more products, on more platforms, with letter protection - 
and selling more as a result. 


And more of these developers are protecting with MacHASP. Why? 
Because MacHASP offers more security, more reliability ami more 
features than any other product on the market. Only MacHASP offers 
capabilities such as network sup|)ort, anti-debugging envelo[)e 
protection, and secure remote :ictivation mid updating. 

MacHASP su[)|)orls the meet advanced platforms, including all 
versions of MacOS and Power Mac - as well as AjipleTalk 
networks. And because Aladdin is a licensed Apple Partner, 

MacHASP guarantees full, transparent compatibility 
with the ADB standard. 

To learn more about how you can protect 
[letter - and sell more - call now to order 
your MacHASP Developer’s Kit. 



'Ite MuctlASP Derebfier's ASf amUiim- 
ntuviktpfukatJwtir 


1 - 800 - 223-4277 

www.aks.com 
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GETTIMG 

STARTED 

by Dave Mark, ©1997, All Rights Reserved 



Getting Started: VerySimpleText, Version 1 


In last month's column* * wc huili uur first 
few applications under the OFEN^JTEP 
environment. We started off with a guided 
lour of OPENSTEP, including the File 
Viewer, dock, nieouing system, and 
terminal emtilator. ITie applications were 
all Ohjeclivc-C coasole apps* None tcKik 
advantage of the user interface clemerUs 
that give our OPENSTEP apps the 
OPENSITP l(X)k^aod-feel. 

'HiLs month's cokunn changes that with 
the intrcxluction of VerySinipleTcxi, our llrsi 
inie OPf:NS*lEP applicaiion. As its name 
iiri[)lies, VerySimpleText is an OPENS'ITP 
version of the Mac'*s clus^sic SimpleTexl 
application. Before you read on, think 
alx}yL flow you would go alx)Ut building a 
SimpleTcxl a]iplicalion. If y<ju are a C 
programmer, you would need to deal with 
menu and window management, fonts, 
printing, emlx‘ddc*d graphics (extremely 
primitive in SimpleTexl), and a host of other 
issues such as Quick'llme, cliplxntrd, 
TextEdit, and memory nianagement* If you 
are using PowerPlant and C++, rhitigs get a 
bit simpler, since you can take advantage of 
PowerPlanPs pre-buill classes. 

'llie OPENSTI:P cools ProfeciBuilder 
and InterfaceBuilder take this approach one 
step further by adding a KAI> (stantLs lor 
Iktpid Application Developjiient) front end 
to the tleveiopment prexess. Pn>jectBuilder 
Ls somewhat like the CodeWarrior IDE, but 
is tightly integrated with Interface Builder 
Interface Builder allows you to create and 
arrange the variotus objecLs/classes that 
make up your applic'aiion and specify the 
relationship between them. 


Ibis month, we'll build a very basic version of dte 
VerySimpleText application, based f>ri a tutorial presented by the 
NeXT folks at Apple's World-Wide Developer's Qmference. 
Don't be fooled, though; the pi-e-built objects that ship with 
OPENSTRl^ will give this version of VerySimpleText some prett>' 
ITOwcrful capabilities. In the coming months, well continue to 
muck around with VerySimpleText. demonstrating just how easy 
it is to work with the OPENS1TP objecls. 

The version of Project Ikiilder and Interface Builder !Ve 
got installed on my system (OPENSfTP 4.2) are a bit buggy. 
Nothing tcKi awful — mostly 1 find myself having to repeat a 
command or mouse click as inierl'ace Builder seems to swallow 
(or ignore) the tKcasional event. 

Though tht^se bugs have been vtM'ified by some of the 
NeXT folks. I'm guessing that by the time this issue of Macl'ech 
hits the streets, a new version of OPENSTEP will lx: available 
and some of these bugs will no longer exist. Bottom line, if you 
are trying to reprcxluce the steps in this column and things 
don't go exactly as planned, jKtiience! Try backing up and 
repeating the last step. 

Oh yeah, thanks as usual Hi Michael Rutman for his 
excellent tech review*.. 


Blfll.DING THE VERYSlMPUiTEXT PROJECr 

• Liunch ProjedBuilclcr (either from the dexk - it's die hamnicr 
icon - t)r fnim inyhost/Next[X*vel(>per/Apj^s/Pio)ectBuildeT.app). 

• Select New^ from PnijeclBuilder's Projed menu. 

• When the “New Project'' panel apfiears (a panel is a dialog 
box)^ navigare to the folder in which you want your project 
folder stored. Project Builder will build a new tbider for you 
using the project name you SfX'cily in the next step, 

• 'I'ype VerySimpleText.Ol in the Name field. 

• Select Application from the Project 'fyp^ pf>pup menu. 

Before you click the OK button, compare your panel to the 

one slKnvn in Figure 1. 
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Now Software 



QualComm 


CONSIDER the possibilities. They're 
wide open. Simply put, OpenPaige"^ can 
do anything you want to the text of your 
software application. 

Across platforms, across architectiues, 
even UNIXOpenPaige Is a feature-rich 
text environment. Every aspect of text and 
layout formatting, editing and display is 
possible. Stylized text. Scaling. Container 
and non-rectangular shapes. Style sheet 
support. Cut, copy and paste. Embedded 
pictures, objects, buttons and even calls to 
other applications are at your fingertips. 

Don't waste time struggling with your 
text. We’ve already done the work for you. 
Drop in OpenPaige and go. Use as much or 


as little of if as you wish. Available as 
object code or as source code, it has 
an elegantly small footprint. Yet it will 
empower you to open doors, boundaries, 
and minds with youi software application. 

But don’t take our word for it. Check 
out our extensive and diverse client list. 
They’ve all discovered how the robust and 
flexible power of OpenPaige can open up 
entire new worlds of possibilities. 

Oiwri 


Seagate Software 


• Paige 


Datapak 


Fbx additional infoimatioTiy check out oitr weh site at iimw.datapa^ or caU m at l-fiOD- 327 -W 03 . 

CopvriDht ^ae? Datppalt Soltwafs. Psige and QpanPaige m trademarks of Dal^pak Sollwart, AN brand or product names are trademarks or regislered Irademarhs o1 their respecllve holders 
Datapak Software ttil5 HE S9lh Street- Suite 1£0 &h Vancouver. WA 90682 • Phone: SGD.891-0642 * Fan: 360.891 9743 • l-mail salBs^datapak nom 


* Vancouver. WA 90602 • Phene: 360.891.0642 > Fan: 360.891.1)743 * E-maii salBs^datapak-ccim 





Figure L The New Pwject Panel used to create the 
V^^ySimpleText.Ot project in ProjectBuilder 

* Click the OK liutton. 

ProjeLtBuilder will create a new folder named 
Very.SimpleText.01 into which it will [)lacc the files it needs for 
your new project. In ProjectBuikler, a new project window will 
appear (see Figure 2). The project window^ lets you browse 
through all the files used to build your project, inciiitling a 
special series of files, similar to resource files, closer still to 
Constructor files, known as .nib files. l1ie .nib files are used by 
linerfaceBuilder to define your prognim's interlace. 



Figure Z We projeci nmeiow created by FrojectBuilder 

Chix k out the project window shown in Figure 2. Notice 
tljai the interfaces ,scdk>n is highlighted showing the list of .nib 
files in this project* In this case, we've got one .nib file for 
NKXI'SThP, and another for Windows. Since I’m ritnning the 
NKXTSTEl^ OS, Til work with the NKXTS'J'hP .nib file. If you are 
ainiiing NEXTSTEP on top of Windtws, you’ll want the Windows 
.nib file* By the time this column hits the streets, you may have 
a third alternative: a Rhapsody .nib Hie! 

• Double-click the NEXTSTEP_’VerySimpleTcxt.OLiiib file in Uie 
Proje<'tBuilder browser, Interfaces section. I'his will launch 
InterfaceBuilder. 


Note that ProjectBuildeCs main menu has the title PB and 
intertdeeBuildeCs main menu has the title IIT If you arc 
conftised as to w'hich application you are in, just check out 
\hc menu window. 

InierfaceHtiikier Entires a numher of windows you 11 get to 
know and love. The plain window^ labeled “My Window” \s your 
appliaition’s window' (Figure 3)* The inspector windttw gives 
you info abc;>Lit and lets you modify the currently selected 
elemenl. At the moment, the inspector is a window inspector and 
lets you modify the application window (Figure 4). The palciie 
window lets you drag various interface elements into jdacc to 
lx.^come part {if your application (Figure 5)^ Various palettes are 
available. Your application conies wiifi a main menu rhai you can 
mociify as you like. I'he main menu looks just like a regular 
menu (Figure 6), so you might be confused the first time you 
look for it. By default, the meniPs title is nextstep (assuming you 
are using tlie NEXTS'rEP .nib). Finally, InlcrfaceBuildeds main 
window (Figure 7) lets you W’^ork with your projects object 
instances, classes, sounds, and images. This window is more 
cximmonly known the .nib window. You 11 iearn more alxnit 
these windows as we go. 



figttre 3, Your appHcaiion's window. 



Figure 4 7he inspector window, set to mspeci a window. 
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Behind every good Mac app... 


Every job requires the proper tool. When it 
comes to crafting good code, BBEdit 4.0 is 
the Swiss Army Chainsaw of text editors. 


"If you have to spend time with text 
on the Mac, you should use BBEdit." 

*- AAocWeek, September 30,1996 


• Compare source files and 

apply differences 

• Open From and Save To FTP 

■ Search and replace multiple files 
using Grep 

• Navigate source files with integrated 
PopupFuncs™ technology 

• Browse projects 



Aloddin System s SiufBt Deluxe, created using BBfdrf. 



Source code from Stufftt Deluxe dteployed in SBEdit 


...is a great 
text editor. 


BBEdit 4.0 




http://www.barebones.com/chainsaw 

To order, coll 617-778-3100 


Bare Bones Software, Inc. 

PO. ikix in4MH Fk'diurd, MA 01730 * main 617-778-3100 • fax 617-77&'31U 


lIUHdtt is iv trfltlirtflArk uf Birp BumL-siSuftwisrr, Im . All uther Imdcmjrte: jnd riT^isti’rvd miihuirrk'i nm pmpertUSiirf thpdr n.ispL'ctivu hukk^ |9*J7 llani? ik>nKrSoftw^v Iw 






































SGII * AT&T UNIX • BANYAN • INTERACTIVE UNIX • LINUX • INflOTOROLA SSOPEN 


PLATFORiy/IS; APPLE SYSTEM 7 • APPLE A/UX • 


Q: What does it take ‘ 
superior client/server 
A: A SUPERIOR S 


^ r 




ST 


START with the 

most advanced client- 
side SDK on the 
market: c-tree" Plus 
at $895. 

■ Oimpk^tc.' "C" Source code 

• ROYAL IT rann 
(Client Side) 

• Multiple ftuppurlcd 
pnjtucoh 

• Fast* p( I liable, reliable 

• Powerful features like 
transacitun processing 

• Win95. NT and 

Windows 3J ready _ 

^ DLP 

ADDb strong, 
multi-platform, 
industrial-strength 
Server that supportsT 

• Pile miTToring 

• Heterogeneous iieiwcirking 

• Automatic disaster reenvery 

• Mu It i-Ui reacted desip 

• Best pricc/perfo mum ce 
available^ Irom S445- $3745 


RESUl^\ » 

A solid, economical, 
easily deployable 
product that frts 
your needs. 

• Portable 

• Scalable 

• l-xecptionul Performance 

• Flejtifalc 

• Easy Server dl^mbution 

• Convenient OFM terms 

FAIRCONT 

5er*vsr 




HeteroQer»©Qu£i 
TCPAP Networi^ 


You can't find a better cliertt SDK wrtb these f^uresl 
Over sijcteen year® ot pnjwmi reliability and performance. 
No cHie else supports over 3Q platforms in this price range! 


c-tree Plus* 

• CiHUpleie C Source 

• Single/MutU User 

• cn lent/Server (optional} 

• Full ISAM functioniility 

• No Royalties 

• 1’ransaLiion Prrxtesslng 

• Pixt'd/Vuriablt; tdcngtli liecoub 

• High Sjiced Datu/lndc^ 
Caching 

• Hatch OpLTalions 

• File Mirroring 

• Multiple Conims 

« Unsurpassed Ptirtabdily 


FairCom* Server 

» t:liunt/Servcr Model 

• Transact iu 11 PmcL^ssing 

• Requires <2ME1 RAM 
> Online liackup 

* Disaster Recovery 

* Rollback Forward 

* Anti-Deadlock 
Rcsoluiion 

" Clicnt-sidc “C* Source 
‘ Muki threatiiiig 

• Hetcrogerteaus networking 

♦ File Mirroring 

* OEM/Source Available 


FOR YOUR NEXT PROJECT CALL FAIRCOM: YOU 
CANT FIND A BETTER HETEROGENEOUS 
CUENT/SERVER SOLUTION! 

Also inquire about these FairCom products: 

d-tree“ 
r-tree® 
ODBC Driver 


FAIRCOIVr 

COI=^F='aFtATIOtNJ 


Snee 1973 

^VWWVeb Add^'^^ h0py/MNwv.baiia]rut»^ 

eoD-saa^aiao 

U,S.A. phone {573) 445-6833 fax (573) 445-9698 
EUROPE phone (035) 773-464 fax (035) 773-806 
JAPAN phone (0592)' 29-7504 fax (059^) 24-9^23 


• HP9000 • RS/BOaa • SUN O/S A*X • 



Figure 5. The ffalelUf unndow. 


nextstepIS 

Info 
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Edit 
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Windows 
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Hide 
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Quit 



Figure d main application nmm. 



Figure 7* inlerfaceBiiiklers main uindow, 
also known as ihe .nih window. 
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Our ncxi step is lo iiiCKJify our app’,s main menu. 


• If you don'r see rhe main menu, click on the .nib window to 
brinj* it to ihc front, click on ilie Instances tab, then cloulile- 
click on ilic MainMenu instance. 

■ In the palettes window, click on ifie menu icon, 

A series o( 12 menu items will appear (two columns of 6). 

• Drag the Format menu onto ytjur [iiain menu, releasing it 
midway between tlte Window's and Services items. 'l1ie 
Formal,submenu will appear in your main menu. 

With that simple drag, you’ve just added a series of powerful 
long text, and [oage manipulation features to your application. If 
ycju had your eye on the .nib window, you may have noticed the 
addition of a new insUint:ej named Font Manager, that appeared 
in the window wdien you released the drag. Note that you tikln't 
have to take any special action to add these pow'ciful foalua^s to 
your application. Drag in die menu and everything the menu 
needs is auLonutlicaily added for you. Later in the column, well 
take a few- of these items for a spin. 

Our next step is to add a .sc'rolliog text arc^a to our main window. 

• In the palettes window, click on the DataView^s it:on (it ltK)ks 
like a wundow in which the word Text is partially visible), 

• Dmg a St rt>Ilahle text view from ilie palette window oiitt) the 
application window (the tme lalieled My Window). 

■ Grab one of the resize handles on the scrollable text area and 
resize it so it almost fills tiie window (leave some of the grey 
background showing so you can still click on it). 

My applic'ation window, showing the scrolbble text area is 
shown in Figure 8. Nt>te the 8 pixel border around the .scrolling 
text area. Unlike on the Mac, the NeXT interface ealls for an 8- 
pixel lx>rder to separate interface eiements. 1 suspect this will 
change under Rliapsody, l>ut when in Rome... 



Figure fil The appHcaiion mndow, 
showing the scrollahte text area. 


YUU 1 HMJMM 



Cross Plotform. 

Mac, Windows, OS/2, Unix 

Database 

Object-oriented, C++ syntax 
Faircom c-tree Plus® 
dBase llh and tV 

R ep o rt-writ er 

Mac & Windows WYSIWYG 
RTF & HTML 

G rapbinp 

Standalone or within reports 

Frainewarlcs 

PowerPlant & MFC 

C od.B-genei'ation. 

AppMaker ond OOFILE create 
complete database applications 

dent@highway 1 *com,au 

WWW. high way 1 .com.au/adsof tware/ 

Also available 
from DevDepot 
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Now we'll Lie Lhe st^roflable text area to the window in such 
a way that when you resize the window, you also resize the 
scrollable text area. 

• Click on the scrollable text area in your application window. 

* If the inspector window is not showing, bring it up by sclating 
InsptxTor.. from the InterfaceBuilder’s Tools menu. Tlie 
ins|X"cLor window should be labeled NSScrollView Inspector. 

* Select Size from the popup menu at the top (.)f the 
inspector window. 

• Click on Lhe scfuare in the center of the Autosizing area so 
that a pair of crossed springs ap}X^ar. 

This will require rwo dicks, one for die vertical spring and 
one for the liorizuntal spring. My inspector is .shown in Figure 9. 
The two springs specify that the scrollable aa-a should grow 
akrng with the enclosing window in both the horizontal and 
vertical dircxlions. 



Figure 9 The f^SScroIlVieKJ insfjector, 
showing horizontal and mfriicai springs. 

I-ct*s Lake this interface for a spin. 

• Select Test Interface from the Interface Builder’s 
Document menu. Note that you could also type the key 
sequence All-r instead. 

The Interface Builder windows should disappear and be 
replaced l>y your running ufiplication with its nexisrep menu and 
application window. You can tell your application is running 
Ixcausc the InterfaceBiiilder icon in the dtxk will turn into a 
master power switch in the down ptxsttion. Put the sample app 
through its paces. Type in some text. Modify the text by seleaing 
various items from the Format menu. Change the font size, style, 
kerning, etc. Try out cut, ct>py, and paste. Resize the window. To 
exit the application, select Quit from the application's menu. 

Thus exercise should convince you of die incredible power of 
die pre-buili Ol'ENSTEP classes. Think about what just happened. 
Witli absolutely no code at all, you built a wijrking text editor. Of 


course, you can add as mutii code a.s you like to your 
applications, customizing what OPENSTEF gives you fur free. 

It is also imponant to note that you did not have to compile 
anything to bring tliis applitation to life. Instead you linked 
together objects that already existed, in this case window, menu, 
and text objetts to name a few. 'lhe ease with which you can 
modify and extend y<jur ** house of obfeas" is further proof of the 
ixiwer of dynamic binding and linking, and of OPENSTER 

Our next step is to add an alxmt 1x>x to our application, 
along with a method to .show the alx>uT box. 

• Back in InteriaceBuilder, double-click on tlie MainMenu instance 
(in the .nib window) to bring up tlie application's main menu. 

• Click on the Info menu item to liring up the Info submenu. 

• Double-click on the Info Panel... item to make it editable. 

• Change the text Info Panel., to read Alx)Ut VerySimpIeText... 

In my version, the cursor disapjxrared as I was typing, nince 
the new text was wider than the existing menu. To verify that I 
had edited the menu correctly, I clicktxl tlie Info menu item to 
make the submenu disap|x?ar, then clicked the Info menu item 
again to make the menu reappear. It was dniwn correcily, resized 
to show the entire “Alxiut Very Sim pie text../ item. 

• With the "'AlKiut VerySimpleTexL./ item selected, Ijring tlie 
inspector window to the front. It should lie labeled as an 
NSMenultem in.specior. 

• Select Anribute.s from the popup menu. 

• Make sure the Dis;tbled checkliox is unchecked. This means 
that the item is now enabled. 

Now well CTeate the Alxm! lx>x window. 

• Make sure the palette and .nib windows are both open. 

• In the .niii window, -select the instances tab. 

• In the paleile window, dick on the window icon (die 
window title should change to "Windows'*), tlien drag a 
window onto the scTrecn. A new window instance will appear 
in the .nib window. 

• In the .nib window, dick on the new windows icon (labeled 
Window) and change the text lielow the icon to read 
AboutWindow', 

Note that we've just changed the instanc:es name. We have not 
dianged lhe windows title. We’ll do that now. 

• Dtmble-click on the instame (the icon .should now be labeled 
AlxiutWindow) to bring the Alxmi window to the front, 

• In the inspector window, make sure the Attributes item is 
selected fn>m the ptipup. 

• Change the window title to ‘‘About VerySimplcTexL..'' 

• Hit the Enter key to tnake the change take hold. The title of the 
window should aciually change when yoti hit the Enter key. 

• Go back io tlie iiis[iecior window and unctieck the '‘Resize 
bar" checkbox (in the Controls area). Tlie About window 

continued on page 16 
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8o... Here^ how m can reach us: 


www.micromacro.com 


International 

Micro Macro Technologies, Ltd. 

3 Hashikma St. 

P.O.Box! 1516, Azur 58001 

Israel 

USA^ 

MicroGuard 

631 South Pontiac St. 

Denver CO. 80224 

USA 

M^c'OS 

Tel: (972-3) 558-2345 

Fax: (972-3) 558-2344 

E-mjiil: info@micromacro.com 

Tel; (303) 320-1628 

Fax; (303) 320-1599 

E-mail: usa@micromacro.com 
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VVt; VC cLUUCU <1 new tllCUC LU inc SUILWcIIC 

distribution puzzle - electronic transactions. 
InstallerMaker creates trialwarc (a time locked 
demo) from your software in less than five minutes. 

With .^0 coding required. The trialware runs for a developer- 
set number of days, prompting the user to buy at each launch. 

Automated purchase aird unlocking to convert the product into 
normal version is fully enabled via Internet, modem, voice, fax, 
surface mail. 

Increase sales and slash costs by safely distributing 
software on the Internet, online services, CD-ROMs and even (!!) 
Hoppy disks. 

Skeptical? Download a free , fully functional copy of 
InstallerMaker 4.0 from www.aladdinsys.com/dev, or 
call (408)761-6200 and ask lor Developer Sales. 
























continued from page 12 

shcHiUi jump lo tlic front and the resize pan o\' tlie About 
window should disappear. Note ihai you didn’t have to hit 
the Enter key for this (‘hanj'e to uike hold. 

• Back in the palette window, selea the views icon (ihe title of 
the palette window' should change to Views). 

• Drag some text fields onto the AlK>ut window, "type in 
some default text and use the inspector to change ihe text 
attributes as you like. 

In this next se<|uence of siqxs, we’re gt^ing to cTeate an 
Alx^url^anelGintn tiler class which will liirndk^ bringing up itie Alx>ui 
windtjw in response to the appropriate seleclion from die Info 
menu. Hie new^ class will contain a .single method called show:. 

• In die .nib window, click on the Cla.ssL^s lab. 

• Click on the line lalxdetl NSObjecU being careful not to dick 
on the little circle lo die left of NSObject. 'lliar circle will 
collapse or expand the classes derived from NSObject. 

• With NSOiijeit sc^krled, select Suixiass fixim the IB menu’s 
Classes menu. A new' sulKlaxs, lalxfel MyNSObjext, will appear 

• Double-click oci the word MyNSObjcct if it is mn already 
highlighted and change it to read AbouiWindowController. 
Ik* sure to hit the Knrer key to make your change take hold. 

This next step creates an outlet and action for die new class. 
Think of an outlet a.s an instance variable or object you'd like 
assixiuted with your class. When InlerfaceBuilder generatt's the 
source ccxle for this class fit will do that), the outlet olijecl will 
Ik* declared in die header file as type id. 

An action, on the other hand, is a uiethixi. Objects that are 
derived from NSConirol (like liuttons. menus, etc.) have a notion 
of Ix'ing activated by the user. For example, a button is pie.ssed, 
a menu item selected. Tliese items use llieir as.st)ciated action as 
a target. Our job is lo link these diings together. 

In our exanifiie. well atkl an outlei named abfWindow to lire 
AlxjijtFanelController ela.s.s. We'd also atld an action metlxxl 
namc*d show: to the class. We’ll link tire *‘AlxJUt VerySimple'lext..." 
menu item to the AlxHiiPanelCkxrtioller and specify that the target 
action is the show: meliKxl. Basically, this mc'ans that the 
AboutWindowCxjntroller jn.stance will get sent a show: messLige 
when the “Alxxii VerySinifileTcxt...'’ menu item is .sek^ctetL 

( realize that abtWindow^ is not tire greatest of varialile 
names, but 1 wanted U) lx* sure to distinguish iKlwecn the lalxd 
AixxjtWindow' under the alxxit windows instance in the .nib 
window^ and the outlet that ultimaiely will refer to that instance. 
IVrhaps t slmukl have gone with aboiitWirxiowOutlet. Ah, well... 

Well also link the AlxnuWindowConlroller instanee (with its 
abtWindow instance) lo die AiKiutWindow instance. The result: 
when the “Alxxii VerySimpleText...” menu item is selected the 
AIkhiL Window window will open. 

Tills may seem a bit confusing at first, but once you follow 
the steps Ixlow', tilings should Ixcome clearer. Creating ouikls 
and actions, then linking instances together is the way tilings are 


done in Inlerfaceliuitder. Lc*t’s try^ it out. 

• in the .nib file, Clawes tab, click on the tiny outlet icon just 
to the right of the word AboutWindowConirolkT. 

'Fwf> new line.s should appear, one labeled (.)utlets and one 

ialKled Actions. 

• Click on the line lalxied Outlets, then select Add Outlet from 
the Classes menu. 

An outlet named myOullet should appear. 

• Change myOutlet to abt Window (you can doublexiick on the 
outlet name to edit if). 

• Click on the line lalx^kd Actions and select Add Ataion from 
the Classes menu. 

• Change the action name to show: (be sure to include the 
trailing colon). 

My .nib window is shown in Figure 10. 



Fifiure 10. 7k" .mh wrmhw, showing the AhmtWmdQii<Amtr<>lk^ 
ck4ss Hilb theahtWimhw outlet ami show: action, 

• Click on the liny outlet icon to the right of the 
AbourWindowCtmtroller label to (xTlapse the 
AlxujiWindow'C^ ml roller class display in ihe .nib window. 

• Widi the AboutWindowConUToller line highlighted, select 
Create Files... from the Classes menu. 

• Click Yes to lK>ih dialogs that appt'ar, one asking whether to 
ca'ale the files and the other asking wiiether to add the files 
to the projeLt. 

At tills [K)int, youVe created the .m and .h files for your new 
class. You can use the Project 1 hiiIder browser to lcx)k at the two 
files. One is fbunti imder Classes and the other under Headers. 
Ncxe thai a method named show; and a variable named 
abt Window' were declared. Once you are done admiring your 
handtw'ork, return m InlerfaceBuilder, 
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GOING 


Are you ready? 

WE'RE 


the way it should be... 

• Multi-threaded operations 

• Unbeatable text manipulation 

• Superior searching 

• Unparalleled scriptability 


L 


See US wn 
l^j^scworld 


handcrafted by the creators of BBEdit at: 

Bare Bones Software, Inc. 

P.O. Box 1048, Bedford, MA 01730 * main 617.778.3100 fax 617.778.3111 



Mallsmith, BBEdil & "II Doe^rt'l Suck*" are trademarks bf Bare Bt>nes Software,, Inc. Ali other trademarks are properties of iheir res|>ective lioldErji, 

©1997 Bare Bones Software, Ine. 











• Biick in InterfaceBuilder, make sure the 
AboutWindowController class is still liighlighted, Lhcn select 
Instantiate from the Classes meniL 

The cube lalx;lcd AboutWindowController (l(x:>k for the 
cube shaped icon in the .nib window, instances tab) is the 
instance of your AboutWindowController class. If your cube 
is labeled Atx>uLWindow, try clicking on it to see the full text. 
That’s what I had to do. My guess is, tliis is a bug. Oh, well. 

Just to avoid confusion, there are four instances you care 
about at tliis point. AlK>utWindawCt>ntroller (the cube) is your 
AboutWindowController. MainMenu is your menu, MyWindow^ is 
your application's main window and AboutWlndow is your 
applk:ation*s about windows 

Now let's connect all this together 

• Find your applic’ation's menu (you can double-click on the 
MainMenu instance) and make sure the Info menu is open. 

• Hold down the Ctrl key and drag PROM the “About 
VerySimpleText..,” menu item to the AboutWindowController 
instance (the culx?) in the .nib window. 

A line will start at the menu irem and a square will appear 
around the cui>e. 

• Let go of the mouse button with the square around the enjbe. 

• Wlicn the inspector window appears, the word target should 
appear in tlic OutlcLs column and the wa^rd show: should 
appear in the Actions column. 

• Click on the word show; and click the Connect burton at the 
lx)tiom of the in.spector. 

A dot will appear to the right of show:. You’ve just added a 
connection to the “About VerySimpleText..." menu item. Anytime 
you w^anl to see the connections from an t)bjcct (including a 
menu item) click on the object and selea Connections from die 
inspector’s popup menu. 

• Hold dowm the Ctrl key and drag PROM the 

AboutWindow'Controller instance (the cube) to the 
AboutWind<nv instance (the window). 

• In the inspeaou click on the abtWtndow oudet and click the 
Connect button. 

A dot will appear to tlie right t)f abtWindow. You’ve just 
connected this outlet (instance variable) to the instance of the 
about window. 

• Select Save from the Document menu and quit 

InteifaceBuilder. 

We are almost done! 

• Return to ProjectBuilder and click on the Classes item in the 
lirowscr window. 


• In the second column, click on AboutWindowController. 

You should now see the show: mediod in the main window^ of 
the browser. At this point, the code should read: 

#impQrt AboutWindowController.h" 

@imp1ementa 1 1 on AboutWindowController 

- (void)show:(id)sender 

I 

1 

©end 

Your job is to add a line to the show: method. 

• Add the following line to the show: method: 

[abtWlndow tfiakeKeyAndOrderFront; self ]; 

Wlicn you are done, your code should look like diis: 
i^import ”AboutWlndowControIler.h" 
jnp 1 eme n t a t ion Ab ou t Wind owCo n t c □ 11 e r 

- (void)show:(id)sender 
( 

[abtWindow makeKeyAndOrderFrant:self] i 

1 

©end 

Now let's build and nm our application. 

• Click on the hammer icon in the upper-left corner of the 
ProjectBuilder brQW^ser window-, 

• When the project build window appears, click on its 
hammer icon. 

• When prompted, click the save and build button (you won’t 
be prompted if’ you already saved your changes). 

A message should appear Siiying tliat your build succeeded. 

• Back in the browser window^ click on the mn button, which 
kxiks like a computer monitor with some w^indows open on 
it. The am button is the rightmost button. 

• When the launch window appears, click the nm button again 
(if you arc feeling adventurous, click on the spray can button 
to bring up the debugger). 

Your application should appear. Take it through its paces. Be 
.sure to select “Alx^ut VerySimpIeText,.." from the Info menu, 

Tiix Next Mon ul.. 

This was a lot to swallow in one month. Hopefully, 
you’ve gotten a taste of the incredible power of the 
OPENSl'KP pre-built object hierarchy. Next month, we’re 
going to take a look at a very cool Rhapsody web site and 
explore OPRNSTEP's documentation mechanism which, I'm 
fold, should make its way into Rhapsody. BQ 
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TCP/IP Scripting Addition 




FTP Parameters 


Description 


Go|>her Server version 2.0.1 

Copyright © 1994-6 by Msrigo Tre-e Softvare^ Inc 

All Rights Reserved. 


FTP Host 


E>ireotory 


Gopher Seruer 


global sockets List 
global newsockets 


Set these parair 
(sending) files i 


Telnet Libre 




"W Description^. 


Telnet Library v2.0.1 

Copyright © 1997 Mango Tree 
All Rights Reserved 


” aet my_telnet^tream to teinf 


Benefits 

♦ Allows rapid prototyping or development 
of Internet client/server applications 

♦ Easily add Internet functions to your scripts 

♦ May be used to script any type of 
Internet activity 

Requirements 

♦ MacOS computer running System Software 
version 7.1 or higher with AppleScript 1.1 

♦ MacTCP'*^ 2.0.4 or higher, or 
OpenTransport'“ 1.1, and a working 
Internet connection (SLIP, PPP, or direct) 

Please visit our website for information on 

♦ Site licenses 

♦ Educational discounts 

♦ Redistribution information 

♦ Fully functional demonstration 


The TCP/IP Scripting Addition’^" allows you 
to quickly develop Internet client/server 
applications using AppleScript®, If you want 
to script with MacTCP'“ and Open 
Transport™, here's your solution! 


Order now through Developer Depot™ at 
aOO-MAGDEV-l of 805^-494-9797 
or purchase online from^dan website 


♦ 




♦ 


♦ 


♦ 


♦ 


The industry standard product for scripting 
Internet transactions, in use since 1993 

Supports Script Editor, FaceSpan™, and 
HyperCard™ 

Build WebSTAR™ CGI scripts that send 
e-mail or perform other Internet tasks 

Automate tedious file transfers to 
your web-site for regular updates 

Create custom web clients for 
specialized web transactions 

Sample scripts include FTP, HTTP, 

Telnet, Post Office, e-mail and more 

Featured on the Apple® Internet Server 


Mango Tree Software, Inc. 

Box 1057 * Brookline, Massachusetts USA 02146 
Fax/Voice 617^327-6663 
sales^pmangotree.Lom • www,mangotree.com 


The Internet Scripting Solution 


All tradcmtirks are pfofiertjes of iheir fespfirNve holders. Copyright O \99J^7 Mango Software, Ine. 
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Debugging with EtherPeek 


Use a Macintosh-based 
network analyzer to 
circumvent the Heisenberg 
Uncertainty Principle and 
debug your network code 


iNl-KODUCnON 

If ycjii developing netw{)rk software 
nntl you’re not using a network analyzer to 
help you dehiig your produci, ytui'll be 
amazed at la>vv much time you can Siive. If 
you are using HiherPeek or a similar pix>duct 
to debug your netwoik cfxle, you probably 
wonder how^ you could lia your job wiihoui 
it. After reading this article, you will have a 
berrer under.standmg t>f the capabilities of 
EtherPeek and how you can use ihtrm to get 
your- \oh done faster. We ll start with an 
overvaew^ ol' network analyzers and then 
move on m \\\v l>ask' leaimt-s of EtherPeek. 
Next, we’ll IcKjk at tlie iiiethodt)logy of 
debugging witlt a netw^oik analyzer. Finally, 
well kx>k at a simple UTI'P client that 
eonmins a trivial bug and then .show' how to 
u.se EtherPeek to help iix it. (This example 
is Ira.stxi on a true story.) 

What is a Network Analyzer AtvvwAY? 

In 1986, when I Ix-gan developing 
nerwork sofuvare on Etherner at 3Corn, our 
Macintosh team was given an internal. 


DOS-based, utility program called "EllierSpy”. After rt^ading the 
sjxx'ifications for 3Com's DOS networking client, we used 
EtherSpy to understand how the DOS client really connected to 
tile .server and to design, develop, and debug tlic^ Macintosh 
version. 1 have used a variety of network analyzer [>ix>gFanis over 
the yeaiT> and 1 can't imagine trying to develop any substantial 
networking software without one. 

A aoftware-fxised network analyzer is a network iiLiliLy 
program that runs on a standaRl desktiJfi or laptop computer 
using a standard Ethernet adapter, A hemiware-kised netw'ork 
analyzer is sold a.s a complete package of a laptop or portable 
czmiputer, Ethernet adapter, and software. (Network analyzers 
are also available for Token-King and other networks.) A 
network analyzer is able to receive all packers on its network 
(IAN segnieru) by using a feature of F.ihemel called pmmiSLium 
mode. Normally an Ethernet adapter and its driver software are 
prognimined to only receive packets tliat are directed to that 
sfxxific athipicr or are broadtast to all atiapters on that network, 
(Packets de.stined for adapters on another network on an irilemel 
or on the iHtentet must be directed to a youten) When an 
Eihernei adapter is operating in promiscau^us mode, it will 
receive all packets on Us network. 

Once in^ifgered, the analyzer software captures ail packets 
on the network using prnmi.sciKHis mode, discards packets not 
matching u.ser-spetified Jillei's. anti then displays the captured 
packets in a liimian-read able foniiat. This human readable 
foi mat is achieved throiigh the use of pn>tocol decoders. An IP 
prottK’oi decoder will know to display the 32-bit IP address in 
dolled dccifiiai tiolalkm, ]>ased on the location of the IP addre.s.s 
within the packet (e.g., 17.234.3 213. Good decoders will take 
this a step further and do a reverse-name kH^kup and display 
the inachinc natiic, such as ‘www.aftplexom,'’ in addition to 
tile dotted decimal ntXalion. 

For most developers, a software-based analyzer is the only 
aifordiible oplitJii. A small rompany may be alile to afford only 


Scan GiJiigati <Sean_CMltigan@opsy.‘;tems.coiii> ha.s Ixen developing t r(js.s-[>l:irrorm netwt>iking soflwjire on llie Macintosh 
:iTu] other phaforTiis since 1985. In 1988, he loiaided Ofxri Systenis Develo[>mcni (OSD) to provide software development 
services to hardware and software manufacturers. CJSD clevelops device drivers, protocol .snicks, and networking applications 
for Macintosh, Windows, and Weh-hased platlbrnis. 
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Increase Your Software Sales 

WIBU-KEY™Copy Protection provides the most ^ 

secure and flexible software protection available. 


WIBU-KEY has been protecting software around the world 
since 1989. WIBU-KEY combines the most sophisticated 
encryption technology with the highest grade hardware 
components to give you peace of mind that your software 
won't be used illegally. You've worked hard to create your 
Mac application. Don’t settle for anything less than the best 
copy protection system - WIBU-KEY. 


Hot plug ‘n play ADB design 
Network support built-in 
Protect multiple applications 
or program modules 
Secure Remote Programming 


• Consistent API for Mac and 

PC development 

• User-friendly setup and 

diagnostic tools for your 
customer 


www.grinecli.com 


a .sofrware-hascti analyser, and getting to a imrdwarc- 

hiLsed analyser in a large company often rc<|uirc5 waiting your 
turn. A software-liased analyzer on be installed on a maeliine in 
your ofrice or in your engineering test lab — you am set it up 
and laive it monitoring your software for extended iKTitxIs of 
lime. Hardware-1 xtsed analyzers do offer a few advantage's, such 
as protocol decoders frjr Sf>me of the mc»re obsaire prfitocols, 
expert analysis capabilities that can find and reconimend a 
solution to a network probleng and the best perfomiance and 
hardw^are error reporting capaf>ililies. In genentl, these features 
tend to lx more useful for network managers than for software 
develfjpers. You shoukt verify Lliat any protocols you need are 
sup[>orted before j jurchasing an analyzer. 

Hiere are several software-based network analyzers available 
for both the Mat:OS and for Windows. In additiofi, there are 
liardware-ixised network analyzers such as die Snilfer froin 
Network General Corpontlion. HtherPeek, fnan the AG Grtmp, 
Inc., with a list price of $995 (developer dLscoonis aie availalile), 
is a fraction of ibc cost of the Sniffer easier to use, and equally 
capable for the vast majority of applianions, (Netwtirk General 
does offer optional modules to decode clicnl/'server messages tor 
Oracle, Sybase, and Microsoft SQL Server This capabiJity could be 
very valuable to some developers.) HtherPeek is available for btrtli 
Windows and the MatOS. 


Basic EtherPeek Operation 
liefore using KrherPeek you must install it tm a system with 
a supixKted Ethernet adapter, IkitlPlii Ethernet on PCI and 
NuBus-l)a.sed PowerMacs is supported. Most other ccmimon 
adapters are supported, but you should t'heck the AG Group's 
web site before assuming a |)anicular adapter Is supported. 
ElherPeek is drag-installable and does not require any special 
files in the System Folder, 

When you first nm EtherPeck you’ll l)c asked to select an 
Ediemei adapter, then the main window will open. Click "Start 
Ca[)iure’' to begin capturing packets in the capture^ buffer. The 
■‘Start Capture” button will toggle to ‘'Stop Cajiture". Click ^Stop 
Capmre” lo end your uace. Figure 1 show's the main window 
with Lire results of a trace displayed in it. Each line of text in llie 
w'indow displays summary' infoniiation for a single packet. 



Figure 1* EtberPiek Main Window. 
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Double-cUck a packet summary line in tfie main window 
and you can view the details of a packet (as shown below). 



figure 2. HfherPeek i^ackei Contenls Window. 


A-S you am sc^e, captunng and viewing packets is very easy, lly 
using filters you cm tell KtherPeek to capture only ]-);icktis tt> or 
frtHii certain addres.so,s or capiure j^iickets containing particular 
protCK'ols. y'ng^m are usetl to tell BtherPeek when to begin or end 
a mice. Filters are typically used to kx)k at a dialog Ixftween tw^o 
specific machines and ignore ihe remaining traffic on your nelwork, 
Liter, in tlie IITIP client debLigging example, we will setup a 11 Iter 
to aixch only the packets honi tlie Macintosh on wliich we are 
def)ugging. Triggei's are useful if you don i kmw exactly when an 
error is going to cx:cur, l>ul you know that llie piiesenc:e of a certain 
packet mdic^ates the error has just occurred or is alx>uE to cxrcur. 

EtherPeck 31 allows you to automatically resolve AppleTalk 
and IP addresses into tlicir corresponding human-reacFible names 
(using tlte NBP and DNS pr(jtcx.’cjls, respectively). You can also 
manually enter names for the 6-byte Ftherncf addresses of any 
adapter cards that you want to moniton 

Looking at Figure 2, you can see that EtherPeek has 
knowledge of the TCP/IP protcKols and uses this knowledge to 
display various fields of Uie packet in a human-readable form. 
EtherPeek uses a set of rules called packet decoders to disf)lay 
these fields. FrherPeek comes with packet decoders for a wide 
variety of protocols and even provides a method for you Co 
write your own decoders (using resource files) if ytni are 
w'orking with custom protocols, 

Antsther extensible feature of EtherPeek is support for 
Plugdns. Plug-las can extract inlormation from packets and 
display it on the screen, log it to a file, send it to a pager, pass 
it to an AppleScript, or even '“speak” the message. In the 
debugging example that follows, we will use a Plugdn that 
displays Web URLs in the packet list. As with decoders, you 
can write you owm Pkig-lns if necessary, 


METHonoiXMiY: Using a 
Neiwork Analyzer m NjVrrow ihe Field 

A network analyzer is mandatory if you am developing low- 
level netw'orking software such as device drivers and protocol 
stacks, and is essential in higher-level netwcjrking software or 
even network-based applications. In this section, well present a 
general approach, or methodology, for using EtherPeek to debug 
network software. For purposes of discussion well refer to the 
software you are developing a,s an application even though it 
could l?e system soffware or a device driver. 

A typical type of error in networking st>ftware is llic '“hexsL not 
responding" category. This is where tlie machine iiinning your 
application sends a message to another machine that should 
respond to it with another mess^ige. Fcir disaission purpases, 
will define a message as the smallest cliimk of data sent by your 
application to another machine in a single transaction. Typically, the 
target appliotion on the other machine sends a message back to 
your tnachine as a resfxmse. Tlie message aiultl lx: as simple as an 
IP (ICIMP) ping mes,siige tliat fits in a single packet or it could ]je a 
more complicated mt^siige that requires multiple Ethernet packets, 

Imagine ycjuTe debugging your “pre-alpha” applicaiion 
and it reports a not res]:>onding” error. At this [Xjint you 

are probably smiling because a few miniite.s before your 
af)plicaik>n w'as crashing. You step ihrough your code in the 
debugger and evcjylliing looks fine: as far as you can tell the 
message was built correctly; tfie send() routine returned with no 
error; if your code is asynchronous, the completion routine w^as 
called with no indication of error; and now^ your application is 
waiting around patiently lor a respon.se, but the receivef) 
routine never returns any data or your receive handler never 
gets called. You tell the debugger to “go” and after the timeout 
period you gel “lu>sl noi responding”. 

This is w'here you pull EtherPeek out of your bag of 
tools. There are six basic explanations for what may be going 
wrong at this point. 

1* Bad Message: You really aren’t building the message right. It 
kx)ks gtK>d to you, but you misread the spccifioiion — or 
perhaps it contained an enor. If you are communicating 
cross-platform, maybe there is an “endian” difference you 
haven't accounted for. 

2. Message Corrupted: The software below the send() 
routine that you are calling is corrupting your data. If you 
are writing an Ftliernei driver and the send() routine you 
are calling is really a register in a [>rototype controller chip, 
maybe the chip has a bug. 

3- Messajje Not Sent: Tlie stjfiware or hardware below the S6nd() 
routine tliat you am c'alling Ls not working cxjrrectly or was not 
configured coneedy and is failing to send your massage. 

4. Message Sent, Remote Host Didn't Respond: A valid 
message was sent io the remote host, but citficr the host 
sy.stem failed to deliver it to the target application on the 
other machine, the target application failed to respond, or the 
send{) routine and supporting s^iftware or hardware on the 
other machine failed to deliver the response to the network, 
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5- Invaiid RcsponsK,* Sent: Tlic remote hast is scndiiig an invalid 
respoasc. Pcrhaf>f> the uirgei applicaiion gave its send() routine 
a bad message or a bad address to send die data ra. Mayl>e the 
ser>d() routine ami its supporting hardware or .st>rtwarc 
corrupted the response data tsr sent il to tlie wrong address, 

6, Response Dropped: A correct response was sent back to 
your machine, hut the software or hardware supporting the 
received routine failed to deliver the message. For example, 
ihe Ethernet driver or protocol sUick could have run out of 
buffers. If you are w'liting an Ethernet driver, the adapter 
hardware coukl have nin out of btdTers. You might want to 
double check your niachine’s configuration, as well. 

By looking ai an FtherPeek trace of the session you can 
view I he packets (if any) dial were actually sent as part of your 
message and iJie resjxmst* message (il^ any). With a basic 
understanding of your mt*ssage fonnat and rlie formal of the 
underlying proicxxil.s (if any), you can usually tiamiw it down to 
one of tile following six explanations. 

1. Bad Message; You will lx: al)le to sec your message in the 
EtherPeek trace. For any normal protQCc>l stack, sucii as 
TCP/IP. EtherPeek will have decoded the prexexx)! information 
and provided you with a separate display of ""user daiii" Uail 
will contain your message. If you see a message and no 
res|X)nse, Itxik closely at your message. Was some padding 
intrcKiuced that didn't show up in the debugger? Double check 
the speclfic^iiion. If you can trace a known working application 
tlmi talks to the same taiget, compare the two traces. If you still 
don't see anything wrong, investigate c:;ise ^4. 

2. Message Corrupted: Similar to ca,se ^1, but die l>ad data you 
see in the message dcsjsti'i look like anything you could have 
done (but don't lx? too quick to point the finger). If parr.s of 
the packet other lhan your “user data'’ arc^ comtpied, that is 
a sign that il may not l)c your fault after all (unless your 
application Is sc’ribbling on memoiyO, 

3. Message Not Sent: Easy to spot — you liave an empty trace. 
(Make sure you have EilierPeek installed correctly and your 
filters are correctly configured, though.) 

4. Message Sent, Remote Host Didn't Respond; You won’t sec 
a response^ mes,sage in die trace. If you're sure dial tlie message 
you sent was valid, then the remote host is the ailprit, 

5. Invalid Response Sent: You see dial die remoLe host lias 
sent an invalid response. Case closed. 

6. Response Dropped: You see a correct response coming hack 
to your machine. If you’re sure your debugger lireakptjim was 
set corretily and no nesptiase was delivered, dien you can 
safely blame die recelveO routine or the configuradon of the 
software or hardware responsible for receiving the me,ssage. 

We’U demonstrate setting up a trace later, but for an easily 
reproducible failure, setting up, amning, and analyzing a trace 
can he done in as litde as fifteen minutes. Widi this much 
information instantly available from EtherPeek, 1 don't 
understand why more network software developers don't use it. 
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Heating Heiseniikrc; 

One of the ni<e,si tilings alx>ut using EdierPeek as a 
ticlxigging L(x>l is iliat is has no eftea on your program’s timing. 
In physics, the Heisenberg Uncertainty Principle says that ytxi canT 
observe a system withoui affecting it. In softw^are development the 
pa^sence of a debugger, let alone actually using one, can cause the 
bug's symptoms to change or go away altogether. Nctwtjrk 
software, particulady at the lower layers, is real-time softw-are: 
packers arc received from other systems asynchronously, timers 
are used to cotnputc time-outs and to retraasmir packets, and 
interrupt handlers contend for critical sectioas. 

You can’t step through this type of code in the debugger 
w4ien you have a problem. With EtherPeek you can collect a 
significant amount of information alxmt your bug witliout 
selling any breakpoint or stepping through your code. 
Sometimes the information you glean from a trace will tell you 
exactly what you must do to fix the bug. If not, you can set your 
initial break|XjinLs much more inteiligently. 

Example: DEBUCGiNCf a Simpij. IITIV Cuevi 

Now, it’s time to sv>lve a real problem with EtherPeek. This 
example is based on a real prolflem that OSD solved for a client. 
(l*he names have been changed anti dien rew'riucn to protect die 
innocent.) To follow this example step-by-step, you1l need two 
Macintosh systems connected to the same Ethernet netw'ork w'ith 
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NeoAccess® displays electrifying performance-up to 
ten times that of the competiticn. Behind Its elega nt 
programming interface is a fully optimized relational 
query engine built for speed. It also has an object cache 
with automatic garbage collection so your applications 
can run in a much smaller memory footprint than you 
ever imagined possible. And NeoAccess has no runtime 
fees so you pay one affordable price no matter how many 
copies of your application you use or sell 


White Others promise cross-platform - MeoAccess 
delivers. Neo Access is a set of C++ classes designed for 
use with popular compilers and frameworks on Windows". 
Macintosh', and Unix" platforms. Thousands of developers, 
Including America Online® and Claris®, have already 
found that Neo Access enabled them to build fast, powerful 
Internet applications in record time. Thafs why there are 
more NeoAccess based applications on end-user 
machines than any other object database backend. 
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;icce,ss to any wcl> server. On one machine you will nin 
lilherPeek and on the fest system yon will run the l)u^y HTTP 
client. Well add some dramatic context, to make things 
interesting, and gel on with the del nigging... 

Imagine you anive at work one morning to lind oul that one 
the engineers w^orking on your project has al7ruptly left the 
company to join a monastery over.sttas. His part ol the project was 
a set of utility programs lo duw'nload files from an HTTl^ serv'er 
He w':is working on a test application called ''WehCxet'’ that would 
u,se the HTTP pioiot:ol to download a single file from a weh 
sen/er. You are asked lo finish tlie tc-st apfilication, so you copy the 
Code Warrior project file to your hard disk and are able to 
successful ly build Wei Kiel. When yoti nm WehGel, h prompts you 
for a URL 10 downkjad. You enter a URL and press return and the 
application hangs. The hard di.sk doesn't sound like it downloaded 
anyihing, so you assume that the download was unsucxe.ssful and 
that the f^rograin faeks some error ehec:king. 

Rather than dive into the source code, yoLi decide to apply 
ihc methodology we examiner! above and take a look at the 
WebGet's network traffic: using EllierPeek. The first thing to do is 
setup a filter to capture only IP traffic to or from the machine on 
witich WebGei is iimnjng. Figure 3 shows the dialog used to 
create an EtherPeek filter named WebGet from Duo that will 
capture only IF packets from the Etlieniet-attached PowerBook 
Duo 2300 on which you are ninning WebGei. 



Figures Filter Settings for WehGet. 


for my network, I check the Address Filter box and enter the 
name SeanDuo IP as the only addre.ss raptured packets .should be 
sent lo or from. This as-sumes that ilie name SeanDuo IP exists in 
EtherFeek\s name table, otherwise I would have to enter a 
numeric IF address. 1 then check the Protocol Filter box and select 
Internet Protocol as the only protocol to capture — this way T c^an 
still use AppleTalk on the test system. 

After confirming these filter settings, I use the Plug-Ins 
dialog hox and lurn off IP Details and turn on Web URL lor 
display in the packet list. This will show me the URLs of any 
web pages requested on the packet summary line in EtherPeek's 
main window. Finally, I dick Start Capture in F.therFeek's main 
window and run WebGcL 
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Purify on Unix 
Bounds Checker on Windows 
Now, from. th#^makers of QC, comes 


On Macintosh 


Kind Bugs Fast 

Spotli^'ht is the first Automatic Memory Debuj^ger for the 
Macinttysh. Instatitly detect invalid memory accesses, baJ 
to4>llT<>x pammeters, leaks, stack overwritas memory rekKa^ 
Uoii problems, and much more. 

Spotlight Lises your XSYM file to automatically putch your 
application — no need to change yrnir sciurce ccxle. No need 
lo recompile. No Le;trning curve whatstHrven 

The interfere gives yon in.stanl feedbuck when an ermr is 
detcctCLl* Yon vjivn ignore the error, ignore all hituR' occiirrenceN 
of the error, or log the error to a text file for hirer analysis. 

Fine Grained Memory Protection 

Spotliglu identifies reads and writes outsitie of the applica¬ 
tion and system heap. Bor it tloes not stop there. Spotlight’s 
CUiject Crxle Rt^iacement iiLstrumenmtion inspects each read 
and write imtruction in your code, detecting faulty memory 
reads and writes that rxzcor hc^rw^een Mocks, in released blocks, 
across multiple blocks, and In ROM. 

This technokjgy works on any heap object yon can alk>- 
caie: Mac heap objects, C^malloc' heap objects, even C+ + 
objects created with new, 

Spotlight .sn t|>s yimr application whenever a faulty menurry 
access is alxiut to txcur and displays the exact source code 
line where ir will happen. Tl\e calling stack is shown along 
with a tlisplay tif all variables. A memory viewer show.s die 
erroneous mcmt>ry address ami conrenrs. 

Toolbox Vaiitialioti 

Six^ilight checks panimcters to over 400 nx>lhox API calls, 
automatically validating handles, memory bk>cks, return val¬ 
ues, and so on. Sj^ecific checks catch subtle errors such as draw- 
itig into an unlocked GWorld, passing an invalid window 


pxunter, passing an address wiihin an unliKkeil hamlle to a 
routine thai may move memt>fy, and ttxi many more to list. 

Leak [>etect]an 

No more struggling with MacsBug. On program exil Spot¬ 
light priwidesa clear listing of all leaked memory showing a 
full stack trace from w^here the memory was alUxrared. Instarvrly 
discover all leaked Mac OS objects, mallockl ohjecis, 
C++ objects, and res^jurces. 

Limitations 

S[H>ilig[u requires an XSYM file to function. MPW and 
C^kxleWarrior users can genemre these directly. Symantec us¬ 
ers must use TtKvlSi^rver to link with an XSYM capable linker. 
Sp<irligln reiiuires a PowerlX^ pn>ccssor. 

SjHilliglit works on the object wxle. No source code is re¬ 
quired: just the thing for testing purchiised third piirty libraries. 

Availability and Pricing 

Pricing for Spotlight DR 1 is $ 199 US (plus $5 shipping ami 
handling within the continental US, IIS for inreniatitmal 
orders). Tliis includes a free upgratle to the GM version and 
access to ftp interim upgnidL^ leading up to GM. QC users am 
CT<ass-gr,Hlc to Spa light for only $ 149. 

All Onyx prtxliicts carry a 10 day no questions askctl money 
back guarantee. 

Onyx Technology, Inc* 

7811 27th Avenue West 
Bradenton, I londa H209 

sa les@L^nyx-tech.com w w w.oi ly x - tech .com 

941 795-7B01 941 795-5901 (fax) 
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Build great applications... BsttSF 

J Breat Teood’nufI ChBBpCf _ 

IboisPlus 


LIBRARIES + FRAMEWORK 


Make cool appb while others are still reading ihetr manuals. 
Profess Iona I iy poiished. Wickedly fast. Delightfuliy efficient. 

. tho routines are more compact tind fhilor 
than anything you might write element 

of Tools P/u^ ii useful... d bargain compared 
coding these routines yourself;^ 




II 

Macworld 


<») 

PlAV 


You build the inter face. 

Tools Plus provides the infrastructure. 

It makes all your pieces work together as an applicdtion. 
With only a few hundred routines, Tools Plus thins your axle 
by tens of thousands of lines. You see results sooner. 
Changes are a snap. 

'All in all, it^$ an incredibiy rich coiled ion of tools... 

If you art? interested in developing applications 
U^at have ^juaHty" written ait over them, then 

T<H>k Plus is hr you.'- MAGAZINE 

Yes, Tools Plus has it! 

» Create any etemeni a single routine 

* Everything works .as soon as you create it 
^ Automates all standard GUI elements 

► Windows. Tool bar and floating palettes 
^ Buttons lall kinrls, flat and 3D) 

» Scroti bars ispeed contrul. Jive scrolling) 

^ World-class custom conlrots 

► Fields tw/scroll bars, filters, auio-editingl 
t PkTure hut torts (the l>est anywhere) 

* Usl hones 

► CDEF and LOEF aLitumatFon 
' Cursors (color, animated, auto-thange) 

' Menus (pufl^wn, hjerarchical, puf>up} 

► Edit menu tundo/rerio, automatic editing) 
t ftmels t3D, group box^, lines, panes) 

‘ 3 D titles (raised or inset) 

* Extended muEfi^monitor and color support 
' Clipboard automation 

* Uynamre alerts (no resources required) 

' Even! processing aulomalion 

► Over 5U0K of custom fonts/ icons, cursors, 
and other useful reisources 

Plus thousands more exciting features and services! 
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Tools Plus for 
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Free Evaluation Kit: 


Avaiblilit «it our web srti’ 
liMpr/Zw Ww.intcrl0g.com/-waten7dg 


Waters EcJge Software 


Looking ai t)ie trace (Figure 4), our arrention is drawn to 
packet ^3i l^ecause EtherPeek'.s Web URL plugdn is showing a 
URL of ai the end of the packet summary' line. Lets douf>le 
click on packet *3 and lake a closer look. 



Figure 4. A Tmce of ibe Problem Session. 


in tile TCP Daia Area field of the Packet Contcncs Windows 
(Figure 5), we sec what must be the HITP GEI' Request. Unless 
you know irm^ fairly wvW, llierc is nothing obviotisly wrong with 
iliis jracket. It says GET/ using HTTP/1.0, Notice that ihc packer is 
lemiinatcLl with a eaniage-renirn/line-fwt! combination (Od Oa), 
which well refer to as CRLK IxMaking hack ar the trace in the main 
window we don’t see any packets lai^c enough u> contain any 
data coming hack from the sc*wer. l^ickets *1, ^ind arc all 
M hy'tes long and ihcref<>re iinisi he I'CV overhead paekeLs. 



Figure 5 7if/e Prohiem Packet. 

let's examine this evidence with our methodological 
framcwEirk from above. The basic situation kK>ks like a “host not 
responding'^ error. We c’an rule out explanations (invalid 
response) and ^^6 (re.sponse dropped), lx,'cau,sc ilie web server 
didn’t send any respoase at all. Since we are talking to a 
prcKluction w^eh .serv'er. we am probably rule out explanation H 
(valid mes.sage sent, remote liost didn’t resixind). It can't l>e ^^3 
(message not .sent), liecause we've seen the request. It's 
probably too soon to blame it on Open IVan.sport, so let’s rule 
out explanation ^2 (mes,sage corrupied) for now. That leave.s 
explanation ^^1 (bad message) as the logical place to start. 

Since tliis problein was jvisi 'Ylnjpped m our lap’’ and we 
haven’t had time to read tlie IfnT sfxx:ifit:tiiion, let's try running 
Netscape 3*0,1 and see what it sends for a request. Then well 
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compare our request with Netsa^pe's and see how^ ours is different. 
Start a new tmce and run Netsc'^ipe on the test system. You siiould 
gel something lltal kK>ks similar io Figure 1 (all traces in diis 
example were generated using IP addres^ses sf) DNS lookup 
packets are nor shown). Packet #4 is the GET re(|uesi fnim 
NetScape 30,1 and is shown in Figure 2. One significant 
dilTerence between Netsaij^e’s GET request and ours Ls that 
Netscape seems to he passing a liandful of parameters of tlie fomi: 

parameter name : parameter value CRLF 
such as: 

Connection: Keep-Aliv^ CRLF 

and: 

User-Aj^ient: Mosilla/3.0 (Macintosh: I: PPC) CRLF 

Do we liavc to add some of these parameters to our 
recjuest? Let’s keep lo()king — there is one more difference?: eacli 
of the parametefs is terminated witli a CICLF, luit there is an extra 
CRLF at tile end of the entire recjuestl If we assume the 
parameters are optional and remove them all, we still seem to 
he missing this extra CRLF ai tlie end of the packet. 

The Problem Function 

Now that we suspect we are Ixiilding our HTTP GET 
Rc:c|ttt:sl incorrectly, Icfs look at .some code. It seems likely 
that the problem might be in a routine called 
BuildGetRequestO (Listing 1). 11iis rourine builds the GET 
Recjuesl ihal w^e saw in Figure 5. It takes as iniml a C string 
containing a Uniform Resource Identifier (URL), A URl is a 
more general form of a Uniform Resource l.ocator (URTJ that 
allows for a relative path. The relative path in this case is V’ 
wliidi tells the web seiver to rerimi the default drxument 
from iLs root directory. BuildGetRequestO takes the lIRT that it 
was passed and inserts if Into a string that conforms to the 
syntax for an HTTP Get Request and puts the resulting string 
into the specified liuffer. A valid HTTP Get Reque.st is defined 
in Section 5 of RFC 1945 "Hypertext Transfer Protocol — 
HTTP/1.O'*. From looking at the RFC (or from looking at the 
correci line of ct)de tliat is commented out), we can see that 
the request requires a CKLE. Now, we just make a onc-line 
code change and itls lime to go home. 



The best high 
performance, 
portable 
compression 
libraries for 

G \ DOS, Windows, 

\ \ OS/2, Unix, 

\ ^ Macintosh, 

\ embedded systems, 

and practically anything 
else, period. 

New Version 3.2 

Robusfi 45-Function API DOS $249 

Buffer ond File Compression Win! 6 $299 

Portoble Archives ond Doto Win32 $299 

Disk Spanning OS/2 $349 

Encryption Unix $349 

Self-Extracting Executables Mocintosh $349 

On-line Help 

Full C Source Code FREE DEMO 

Tel 60 & 245 ' 4]75 

kAlt^vrx 606'245’9305 

DC Micro 

Ss Development hhp://vvvvvv*dcmicro.com 

Call 1-800-775-1073 



int BuildGetRequest( 

char *thelJRI, // LTRJ to retrieve 

char ’‘requestBuffer) //Where lu pm rt^iucsi mcssiige 
t 


// Invalkl RTTP 1.0 (missing a CRID - 

char ircqucat l] - "GET Us HTTF/1.Q\0i5\Q12“ : 

// Correct liTTP 1.0 (has two CRLF’S)... 

//char request! I = “CO Its HTTP/DO\ 01 S\ai 2 \ 01 !j\OX 2 “: 

// liuild the request meijs;^e 

sprinrfCrequestBuffer. request* theURI): 
rettirn tioEtr: 


Listing 1 : BuildGetR^uestQ_ 

Btiikls an HTTP Get Requetit to retrieve the speeifted tJRI. 


BuilUCictRcqucsl 


// liLiildGetUequtTiiO 
// 

// Builds an KITP Get Request to retrieve the specified URL 
// 

// Inputs: 

// the! iRl C String with TIRI to retrieve 

If requesiBufler Pointer to buffer to return built request message in. 

// 

// OulpuLs; 

if 'requestBuffer Btrffer will eoiiiain the aquest message 
// 


Conclusion 

We have just used EtherPeek to fix a bug in unfamiliar 
ccxle that u.ses a protoccjl with unfamiliar interna Is. Although it 
was a relatively simple example. I’m sure you see the full 
potential in this method of debugging. Ry using a network 
analyser to quickly eliminate possibilities, you can greatly 
reduce or even eliminate much of the time you would spend 
stepping througli your code in a debugger. If you are writing 
or tiebugglng network software, you should definitely add 
RttierPeek to your loolbc^x! Hi 
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SCRIPTING 


hy Cal Simone, Main Event 


Dynamic Debugging of AppleScript 


Special debugging 
techniques for a 
special language 


T\lking Aboi^j AppuiSt’JUKi' 

AppItfSt ript is the st^ripting language of 
llie MacOS. Much t>f AppleSc ripi's .synuix 
resembles that of a human langmge — in 
many c^Lses, you can write grammatically 
correct, imperative senleot es to cnnTiT>l your 
computer But die exjxrrience of debugging 
AppleScript scripts can dilTer significantly 
fnim that of debugging a regular appliaition. 
In diis article, 1 11 discuss: 

• Debugging piugruiiis in traditkmal 
programming languages. 

• What's different ab(Hir debugging 
AppleScript. 

• What comprises dynamic debugging 

• flow to debug an A|7pleScript script 
using these techniques. 

• Special topics, such as deliugging 
handlers, messages that originate from 
outside a script application, and 
AppleScript CGIs. 

• S(>me extra AppleScript debugging 
goodies. 

Lvriii'Kf Rinse, anu Repeat 
(The Traoitional Debugging Cycle) 
In most traditional programming 
languages the debugging prcKess goes 
something like this: 

• 1'ype, copy, and paste in an editor to 
create and modify your source code. 


• Compile your program into execTJtal>le 68000 or PowerPC 
machine code. 

• Run your program. 

• Discover a bug and figure out the problem. 

• Repeat this cycle until there are no more hugs. 

For traditional [irograii lining languages, this ed it-com pile- 
run-debug cycle is normally line. When you start your C 
prfigram over each time to run it, you’ll usually start over 
executing your program with a dean slate — everything’s gone 
when you start anew, 

Debuuiinc; in AfpleScrifi 

AppleScript dilTers from most traditional prograoiming 
languages in a numlxT of ways: 

• AppleScript has a natural-language syntax. It often consists of 
human-readable constructs such as tell the application 
"WordPerfecr to print the second window. Fkx’ause of this 
human-readahility factt>r, AppleScript's audience includes 
more than hard-c‘ore s^iftware developers. 

Programmers [Kxssess the abilities io think logically, to pay very 
close attentkjn to deUiif and to work adejidy witli absiracl 
symlxilic notation. But a much wider variety of experience and 
technical skil].s are found among stripters — m fact, many 
people who write in AppleScript can't or don't [imgrarn in 
regular pnigmmming language-S; a great many don’t even think 
of thenixselves as programmers. While ihtry can think logically 
and do well with detail, they aren't coinlbrtaiile translating 
more cryptic symlx>lic notation into a set of instructions. 

St>, in addition to software developers, among scripters we 
find power users, system administrators, and the guy or 
gal who help.s others in iheir department set up scripts to 
make their work a little e^tsier. (Hven the nomenclature is 
different in the AppleScript world — we see terms .such as 
“command"', “handlef'\ and “message\ instead of words 
like “statement", “function"; and ‘"code".) 


Cal Simone <ail@scripi.oig>, Preskleni of Main Event Software <ww'w.niiJtnevenLcom>, and founder of the AppleScript 
Lmguage Ass<x;iation <www,script,o(g>, defines the essence of user-authcjrahility. He is rt‘leruless in his efron,s to iiaike 
AppleScript use as widespread as j-HXSsihle. 
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It’s Macintosh Accounting At Its Best 


W" 


E X ] B L E 


riexWarc Is designed 
lit give you almost 
uiiliriiUol possibilities 
as your ctuiipany 
grows. 



Flex Ware's accounting 
features atid reporting 
capabilities give you 
informal ion you'll 
rely on daily to make 
smart decisions. 



|e businesse.s consis¬ 
tently choose RexWaie 
because of its exceptional 
speed on network araJ 
ciicnt/serx'er systems. 


Meet your clients’ needs with the FlexWarc Development 
System. FlexWarc is an integrated, mt)duiar,jWat't/. 5 e/' Rccoinmciids 
award-winning accounting program that you can modify and 
customize to suit each of your clients’ requirements. Take advan¬ 
tage of FlexWarc’s top performance and adaptability. It’s flexible. 
It’s powerful. It’s fast. Call the FlexWarc Sales Department at 
888-353-9927 for information on the FlexWarc Development System, 


RexWare 


ACCOUNTING 



3715 Atherton Rd. #1000 Rocklin, CA 95765-888/353-9927 - FAX 916/624^757 
email: sales^exwarexom. httpy/Www.hexwarexofn 


• AppleScript d<x!s intentpplic'^ition communication, A great 
cleiil of AppleScTipt's )>ower is drawn by k‘veraj*ing otlter 
existing applications, known in die AppleScripi worid as 
target applicaiions. A single line of AppleScript atn send an 
interapplication messa^i^e (an Apple event) to a target 
application that may cause a tliousand lines of C cotie to be 
execLitcd in iliai application. 

What's diflerent in a scripiin” srenarkt is that, when you 
enaninter a bug, fix it, and run die stTipi again from the 
lieginning, yotiYe not just starting the scTipt over — one or 
more target apjilicaiions may he part way dirough a 
scenario. For example, the script may cause target 
applk:ari<)ns to create or delete ckxunienls, files, or database 
recordsS, and data (and visual representation of data) may be 
rearranged or tramsformetl, Further, some of these 
applications may lx‘ on other computers. Kach lime you start 
your scripi from the Ixginning, these target applicaiions 
must lie reset to iheir re.spective starting points. If youYe 
ever gtdng to get done delxigging, sianing the .script over 
each time Isn't really an acceptable solution. 

■ AppleScnpl is exiensif)]e. because any application or .scripting 
addition can extend the Ap|)IeScTipi language, the vocabulary' 
and the meaning of that vxxrahulaiy can be tlifferenr, 
dcjxatding on wfiit^h appitcatitin you're communicating witii 
or controlling, tk), while debugging, you must able to 
pix)fte the target applications as well as the scripi. 


The Dynamic Debugging Experience 

To me, the essence of dynamic: dehugging encompasses 
the ability to affect the scenario in which a program or script 
runs, while executing step by step, and the ability to affm ihe 
program or scri[)Fs slate w'hen a hug is encountered, without 
the necessity of starting over. Home dynamic languages (and 
oc'casionally interpreted languages) do have Uynaniic 
debugging meclianisms. SmallTalk, LISF, and Dylan are 
examples of such dynamic languages. 

Changing state 

Nearly all developmeni environments for compiled 
languages, whether dynamic or not, have fac:ililies For 
waiching the values of variables change as the program 
executes, Soiiie also allow modification of data values in the 
middle of debugging, thereby affecting the program's state. 
To do proper debugging in AppleHcript, you must lie able to 
modify a seriprs variables. 

Affecting the scenario 

Some dynaniit: language envifonmenis provide the ability to 
execute individual siateuic'nls on the lly wiiile delxigging a piognim, 
as if the .statements were tyjxd inline. lk.xause <jf A[)pleS<'ripi‘s 
inierapplkation communicaiwin capabilities, tl'ieie'll lx tunes when 
ycxfll have to tiKxlify the Mcnario outskk* the script, including taigct 
appliauions tliat the sciipt is ctunmuniaiLing wiiU or c:onttolling. 
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OPTIONS 


filx accounts to choose from 
packed with features like 
CGI, secure server, audio 
support, FTP and TELNET 
logon access with plenK of 
storage space: all at stable 
and competitive rates. 

Full internet merchant 
soludotts and OD-line 
payment systems make doing 
business on the web easier 
than ever before! 

You’ve 
Found 
Your Web 
Home 


SUPPORT 


Full on-line does, fast 
response customer support 
and available webpage design 
make your adjustment to our 
servers a breeze. 

Your success on the web is 
our success. Personal and 
business sites stored the easy 
way: with NO HASSLES* 


Furdicrmore, depending on how you're using AppleScript, 
you may also have to handle messages i\m originate from 
sources outside the script. This is particularly necessary if a 
script is going to be used as a standalone application, such as 
an AppleScript CGI application for your Web server 

Because of the rich set of tools available, many of which 
were devek>ped specifically for use with AppleScript, Til be 
using Scripter to demonstrate the debugging techniques 
described in this anicle. (Information about Scripter is 
available from <http://www.mainevenbCOm/>,) When Scripter 
was designed, the goal was to make the experience of 
debugging reflect the way AppleScript w'orks. Also, the 
process of debugging scripts had to he made easily accessible 
to people who have never used a debugger before, and yet 
provide the serious scripter with advanced tools for 
perfecting larger production systems based on AppleScript. 


being exeaited or the lop leveL (A handler is a routine that is 
either called like a regular subroutine or executed upon 
receiving an Apple event mes.sage from another application. Tlie 
top level consists of commands diat aren’t in any handler and 
exectuies wiien you run the script.) 

While stopped at a step, you can type, paste, or drag any 
AppleScript commands into the Instant window and execute 
them as though you had typed them inline, 'fhose commands 
can use and modif>^ variables as well as execute fiandlers in tiie 
script. This means you can often repair problems when you 
encounter them. Sometimes, by fixing things as you go, you can 
reach the bottom of the script in a single debugging session, 
having found all your problems. As in the Observe window, 
commands exec:uting in the Instant window apply to the scope 
of the current handler or top level. 

When you're done debugging, you liave to go back and fix 
up your script’s source ctxJe. I don't know about you, but I 
usually figure I've only got one or two problems to fix — tfieyil 
take only 10 minutes — and the script will l>e perfect, right? A 
few hours latej-, having found all the bugs, you emerge bleary- 
eyed, but Iriumphanl, at the bottom of your script, something 
that miglit have taken you two or three days if you had to modify 
the source code and start over each time! Ht>wever, now^ you've 
got to fix up your strript, wliich means you have to remember 
what you did at the Ijeginning of your debugging session. And 
naturally you always write everything dtmn — NOT! 

To help you figure oui wiiai you need to modifv^ iliere's a 
l.og windtwv that shows you not only the commands you 
stepped ihrougli (and the results generated by each of those 
commands), but also your errors and fiie fixes you applied. So 
what you end up with is a guide to fixing up your source code 
after the debugging session. 

Let’s Do One (A Debugging Session) 

Consider the following simple, yet problematic script: 

global a 

to BusipAndSquare(x) 
fjat tenp ts x I 
set temp to tense * temp 
return temp 
^nd RumpAndSqiiare 

set a to I 
set b to c 
BumpAndSquare(bJ 
set b to the result 
tell the application Tinder* 
close th(* front window 
end tell 


Tackiiiig the beast 

In the Scripter environ menu wiiile sujppcd at a particular 
command in the scripu you can fiddle with your saipt's 
variables, evaluate expressions, and execute commands. 

In the Observe window, you can watch the values of 
variables and expressiems as your stTipl executes each step. 
More imponanliy, you can define or modify the value of any 
variable while stopped at a step. Note that the values you see or 
change are applicable to the scope of the handler currently 


Before you start, close all the windows in the Finder (or 
you can use another application that supports the object 
model). You can w-atch the values of a„ b, and c in the Observe 
window. As you step through the script (using the Step or Auto 
Step menu command in the Script menu), first a is set to 1, tfien 
you encounter an error on die second line, because you can’t 
use c l>etbre it's been given an value. Figure 1 show^s the 
Observe wandow wdicn this error is encountered. 
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Obserue 


f Add \ [Remouel f load 1 
[insert! [Rem, ftllj f Satie \ 



' buggy example - | 

• 

d 

t 


* 

b 

* Undefined * 


9 

c 

* Unaerined * 






0 0 



figure 1. Waicbing variables. 

You can double-click llie “undefmed" value for c and enter 
a numlKT (for example, 6J co give c a new value, Now the 
second line W'ill work, and you can continue stepping tlirough 
your script without having lu start over. 

Intridenially, if you step into a handler (by holdmg down 
tlie Shift key while stepping), then you can modify tlie values of 
variables that the handier lias access to. In the example, while 
stepping inside the BumpAndSquare handler, you can see and 
nuxlify the values of a, x, and temp, but not b or c. Clicking on 
the Observe window’s iw'isi-down triangle will show which 
hander you’re currently in. 

Later in the script you'll encounter anotlier error [secause 
the target application has no windows to close. In the Instant 
window, you can tell the Finder to open the startup disk as 
shown in Figure 2, (Jl' you're targeting a different application, 
tell it to make a new wundow or document.) Again, the line 
with the error will now work, and you cm continue stepping 
through your script. 


Instfint ' ill 


- buggy example - 


tell application ""Firater" 
open the startup disk 

enil tell 


startup (fisk of appheetioii "Finder" 


O 


jg 


figure 2 fxecuiing a command *'on-ihe-Jly." 



Lole Night 


Script Debugger 

Completely Rejtlaces Apple's Script Editor 



‘...the pmgtm [Scrifa Debi^] 
isi 

DiclmotY \Mow, svpetbsciiiiling 
Mtkm and compkte scf^tiMtY 
mote it 0 tfery good choice." 

Avi Happopori and Ed Allen 


Soipi Uthiiggirr is 2 peywetfuj 
and flexible .AppleScripl™ auiboring 
looi ilm las novice iind seasoned 
scrip* writers get iJie from 
ApjjicScripi. By combining an 
easyno-use imcrt^'c wiiti cxiensive 
devtdopment toois, li makes script 
writing faster and easier ihan 
ever before. 

Scripl Debugger, recently 
oweidedafive^iiousemtingin , 
ModJser (UK edtbon), offers; 

■ Mo 32K fimii on scripts 

■ Tfua ixonition of a II 

AppkScrlpiscr^ 

m k powofful scripting invipoment 
ihor incluks Oiog & Drop idiling 

■ PinrarKMotivo 

m Scriptobh and (tfiodioliie 
Keep cnrreni with your Script 
DehLigger upgrades — visit our 
Wdi site: btip://www'.Liienigbisw.com 


Uite Might Software Ud. 
Voice m) 929 557S 
Fax (6041929 ^961 
E-mail gtubin@wiinsey.com 
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® Log AH Show Events 

O Errors Fixfes 0 Shew Steps 

OOff 0 Show RosuHs 

0 Clfaf* B#iw«9n Runs 

S4t i to 1 


—> 1 

pi 

set b to 0 

w 

—> The variable c is not define4. 


— From Obseryo — 


Th« value of 0 was ohanaod to 6 


-- End Observe “ 


set b to c 


—>£ 

li 

Bump AndSqu areCb) 

islji 

—>49 





figure JL A debugging session Log. 


Next, if you open tlie Log window, and ^tart your 
debugging session again, you1I see what youVe exetaated, and 
w'hen you apply the fixes, they are also shown. (See Figure 5) 
Now you can use Uie log as a road map for adjusting your 
source code to fix the bugs you found and to handle problems 
you might encounter, such as finding out if the front window^ 
exists before aitcmpiing to ckxse it. 


Experimefitatlon 

Along the way, die Command window ofters a number of 
interesting possibilities for exploration. If you want to try out a 
series of single commands to see the cumulative cffecL you can 
type a line of AppleScript in the Gimniiind window and execute it, 
then type another line and execute dial, and see the effect of each 
new line on w^hai aune before it Tliis exix*riinenlation can be 
carried on without affecting the scTipis in other editing windows. 
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Mac, go out and touch the world 

ADB I/O lets your customers' Macs ixytirol things, it lets them [gg!. 

I ADB 1/0 lets the Mac be pari of Itur jjhysical world. 

TKousamis of lis^ 

B1 Sdence, Multimedia, QniJtfrcnS Mifioiims, Horne Automation, 
f heatre Stages, Industrial Testing, Mcdicnl Research, Bonsai 
Watering, Robotics, Weather Stalicxis—anything that can 
tx; ctelJonically measured or controlled can use the ADB (/O. 

No Serial Ports Ckcupied 

ADR I/O Ltse^ I he Apple Desktop Bus to communicate inputs and 
orUpuls to and from your Macintosh. (Maximum pdlirxj frCTjuofxy 
Is 901 U.) No external power supply is needed. 

Eight I/O Channels Provided 
Foul rdays for OLitprjt. Tour channels for Digital In, 

Digital Out or STiil Analog In. 

Extensive Software Support 
Wtth ADB I/O arxl ruiarty any environment/ 
it is easy to bdk) ajstcsmi/al 
applications for your oxktrol and 
data acquisitioft needs, 
f-or more Info, visit us at 
WWW, bzzxzzzxom, 


You am also as.srxiate iht" Command window witli a 
pailicuiarappUaition anti have a “conversation'" ii.sing AppleScript 
commands, to get infonnation alx>ut that application's propenies 
and ol>jet:l.s, or to try out various p^^ssihiliiies to help you figure 
out the right way to expres.s a pa nk ular act ion. 

Debugging Handlers 

In AfipleScTipt any hiintller in a siTipi can he called from 
within the script or from anoiher appliatiiori. Trying to debug a 
handler tan In.- tricky. You ct)uld comment out the liandler 
declaraiitm (die to or on lines) and the end line, then type set 
commands icj simulate the panimeter passing, and step through 
the resulting script as if comniands in the handler were top-level 
txanmands. Or you could type up a fake call and step inUj it ironi 
the lop level of the script (as in the example above). 

Both of these metlKxls liave drawbacks. First, having to 
change anti reverse what you do arch time you save the script Ls a 
pain. AfstL ytju are breaking a cardinal nile of programming — 
debugging a version f>f ytair script ifiat's dilTeaml from the final t>ne 
you're going to use. Not only might tilings lx‘have diherently 
Ix^tween your original and modified veisions, but worse, if ytJU 
forget, and save the .script with yotjr nxxliUcaUons, then you'll have 
extra io|>leve! comm:mtis thai you definitely ckin't want. 

An integral |)an of the dynamic debugging .s^'enario in 
Si ritiler is die Call Box. You am start a debugging sassion for a 
particular handler by typing and iniLiating a call. In the previous 


example, you'd type a call like BumpAndSquare(7 * 6). Upon 
calling the liandler (see Figure 4), the step indieaior in die script 
window points to the Rrsi line and you can step normally 
through the calk The Observe, Instant, and Log windows are 
available to you wliile debugging. When the call returns, the 
result will be appear in the Call Box, so you can see what your 
handler would return to die culler 



f igure 4, CaUiug a hamiivr 
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Start Designing in Minutes With 

QniekCRC 


Identify Objects 

Discover the objects for yotir desi^in 
using C-KC cards (class, responsibility 
anti collabtii'iitions). Create a card tor 
each object that identifies its relation¬ 
ships, attributes and responsihililies. 


m File Edit Report inttidoui Option 
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Simulate Scenarios 


Create scenarios tbai 
step through the 
mechanisms in your 
design by using the 
responsibilities of 
objects or by calling 
oilier scenarios. 

Now siiimlate your 
design to make sure 
it works. 


huHiKiii t 

«C>M «■ arfitll** tHUalltoijif 

#aa4Bm |l 

MPl I ■! > %%WM 

[ Ifeaat im ^L alifci r mpaBitMitq u 
nai^afliWilllg VHiir^lnH laa Ciiin l^ucua 


Use Your Design 

Cist your design to text and 
use it as a code sf^eciflca- 
lion orexptiri it to 
MacA&D or Wii»A&D for 
detailed design and citde 
generation. Use MacTninslatoror 
WinTranslalor to automatically generate 
QuickCRC cards from existing code. 


BeSOr I.P'’IBM Mike BUM 
I OEffii: 

lW»pM Ik -ll I I Mv 'll,4 i I ui 
Cteaa-ipHj*.. Inlxlu4 
J^hPi^wria hi ) My lamifl 
ilHaor-1 pi I Ik* 
ilffTpoiK h, IMij U-4 14 

.. .Ihisa'lp^l vi: wl u 
hi |iti4 [kw 
iThH t 

'■ILLi il»!LM klibiu 
(V’amp'tim 
riMriNi** 

. . Uufir I pilon Id.! 
PLAOt^ ^(V^P ere t 





OiPUmtttll 
OM la^afijiMa 
#■11 mUKHVWl 


f—MfiiiijifTn - 


I (aniifl I 


havi ■ ipiMi 
M fc 11 BH^ 
[•]n<i4pan 


(.'rKitir Ami Mmubit 1 Mr Dr4tti 
I" Will r«C ( siiiv 


QuickCRC 


Muciuttish or Windows 95/NT $595 

Nr iitfonfiiilimi: 

http://w w w.exceiMpft ware*cuni 


Automate The Process 

QuickCM<C has the Features you expect in a design UhjI, like 
the ability to maintain relationships between cards and 
scenarios as Fluid design changes take place. For complex 
projects, objects can l>e grou|>ed functionally into separate 
tl i a grai ns. QuickCRC ca n v i .s u a 11 y arra nge card and seen ario 
ohjecls lor you to highlight rclalkmships. Design models can 
be veriHed to locate errors. Use QuickCU'tC to collect your 
ihttughl.s and put design ideas ow paper in minutes. 


Excel Software 

Computer Aided Software Engineering 

515-7,S2-5359 

Fax:515-752-2435 
i n lo @cxtclso It ware.com 


MncAmilysC Mik:'! ransbliir, WinA&D, WinTninsliilor nnd 

QuickCRC arc iriiikninrk.s tif BxccL S<iflwai'c. O E9^}7. All rights ii*s(,Mrvi'tl. 
Other briiiul arnl nrocluct ntiiiK^s ure tUHtcniarks (it iheir respective litikleis. 














































































































































































MkLinuX 

Microkernel Linux for the Power Macintosh U \ 

Why wait for Rhapsody? MkLmox is a complete system, 
based on Linux 2 and the Mach 3 microkernel. It includes a 
complete software development system (gcc, gdb^ perl, -0/ 
X11R6.3, and hundreds of other commands. Get MkLinux 
and start working right now with Mach, Objective-C, UNIX 
development tools, and more.,. 

MkLinux builds and runs most Intel-based Linux software. 
It works efficiently and reliably on a wide range of Power 
Macintosh platforms, with other ports on the way. MkLinux 
has an active user community and a substantial Reference 
Release, both sponsored by Apple Computer, If you want to 
get a jump start on Rhapsody, this is a great way to do it! 

Visit Apple's MkLinux web site {www.mklinux.apple.com) 
and Prime Time Freeware's web site (www.ptf.com) to find 
out more about MkLinux and other fine freeware products. 

Prime Time Freeware mfo@ptf.com 

370 Altair Way, #150 (408) 433-9662 

Sunnyvale, CA 94086 (408) 433-0727 fax 


Calls from outside the script 

Even more tricky Ls debugging Apple event messages sent to 
your script from anotlier application. After clicking two check 
boxes (one in the Cali Box and one in the script window), You 
are now sni up to debug me.ssages received by your script. To 
stimulate this, you can send an Apple event message to St:riprer 
from Apple's Script Editor (or any application tliat could send 
Apple event messages), by executing the following script: 

tell the application ’'Scripter” 
set X to / 
set y to 6 
EumpAndSquaretx y) 
end tell 

The message BumpAndSquar0(42), complete with the 
pararnoter value 7 * 6 evaluated to 42, appears in the Call box. 
Tlien you can cal! tlie handler using ibis message, step liirough 
the handler, and the re.suIt will be returned back to the sender 
(in this case Apple’s Script Editor, or whatever application sent 
tile message) — true inLerappiit:ation message debugging! 

If your script is going to be used as a standalone aiiplicmion, 
such as a CGI application, you can use a teclinique called 'live 
editing” to arrange ff>r the actual messages nonnally sent to that 
application to be sent to Scripteds Call Box. Real CCJ data values 
from your Web server can appear in die Cali Box. (See Figure 5 ) 
So you can debug not only the pans of your script that handle 
messages, but the messages themselves. 


f Call It 1 j - 

eool.ecqi “ 

Q Mo 

(•) Manual ; 


J2I Catoh Messages 


.^ 

f muttons:.* 1 

7; .. .-n.. *..A- .-A • ^ . ;• V. - 


«event WWWflsdcc» "" given «cl ass kfor»:"“,«cl ass use 
Agnt»f Mozil1a/2.0 (Macintosh; I; 6610",Kact»:"A 
□Referer: htfp://255.255.255,255/ceVcool.html 
DConnection: keep-^^live 
OUser-Aqent: Mo£illa/2.0 (Maelfitosh; I; 68K) 

□Host: 255.255.255.255 
□Accept: image/gif, image/X“XbitmapJ mage/jpeg, image 
□Content-type: appltcation/x-wv-form- urlencoded 
□Content-length: 50 
□ 

□ r egl o n=no r t h^catego r g -A&c ha rtSt y] e=ba na me ^3 u b m 




M 


Figure 5. A message sent to a CGI, captured in ibe Call Box. 


Reentrancy 

In AppleScript, if a handler Ls executing and another 
message arrives, the first message is interrupted and the second 
mes.sage takes over, initiating a second handler call. If a third 
message arrives, the second message is interrupted^ and so on. 
As each handler finishes, the next most recent message 
continues from where it was interrupted. You can simulate this 
behavior either by manuaOy making calls in the Call Box, or by 
.sending Apple events from another application. 

Extra Bonuses 


Persistence 

AppleScript scripts have special global variables (called 
propefim)^ which can he initialized at compile time, and 
whose values persist l>etwccn executions in applets 
(AppleScript applicatioas). When an applet quits, any values 
for the properties that were changed while the applet was 
running are saved to disk. The next time the applet is 
launched, the properties are given the last saved values. When 
you’re debugging, you have a choice l>etween allowing 
property values to persist between executions or debugging 
sessions (to help .simulate tiie .script running in an applet), or 
automatically clearing tlieiii out each time you start. 

Error hatidling 

AppleScript has a mcchani.sm for catching and handling 
runtime errors, known as a tty block. Any errors encountered 
in the try part of the block will drop the script into the error 
handling part of die block. Thi.s allows you in gracefully 
handle errors encountered in your script. 
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However, AppleScript doesn't differentiate Ix'tween a 
genuine runtime error and a bug in your script — when you're 
debugging a script, you don't want bugs to be caught and 
handled by the error handler 

The example below shows what Ls a real mniinie error, 
depending on the value of y. Normally you would want this error 
to f)e cauglit by the error handler; 

try 

set ^ to 5 / y 
on error 
set X to 0 
end 


On the other hand, tliis version is a bug in your script which 
you don’t want to go into the error handler: 

try 

set X to y / 0 
on error 
set X to 0 
end 


You can turn off the error catching mechanism, step tlirough 
the script, and if you encounter a bug, the script will stop as 
though the error handlers are not present. If you discover that the 
bug Ls really a genuine runtime error, then you can turn the error 
handling mechanism back on, and step inm the error handler 

Recursion 

In recursion, a routine is called from inside itself. Recursion 
is used for simple factorial computations or to traverse through 
nested folders on a disk (which requires starting through a sub¬ 
folder while you're in the middle of going through a folder). It's 
interesting to watch the recursion build up and unwind. 

Here's a standard factorial routine that calls itself, modified 
slightly so you can watch and play with the value of x: 

on factorial( k) 
if X > 0 then 

factorial{x 1) 

return x * result 
else 

return 1 
end if 

end factorial 
factorial(10) 

You t'an watch the results returned as each level of 
recursic]n unwinds. In the Observe wmclow, you can see what 
level of recursion you're in, and modify the value of x for the 
current level of recursion. 

It’s Aodktive 

These dyrmmtc debugging iet:hnt(iucs an: instructive and fun. 
ft'll take you less time io find your errois and perfea your scripts. 
And you'll find and fix bugs that you wouldn't have known you 
had, so you 11 end up with higher quality scripts. Whcilicr you're 
nuking scripts for your own dcsktof> use, or providing scripts for 
iliose an)und you, you’ll have a much liigher degree of saiisfaaion 
and you'll accomplish a lot more with AppleScript. H 


Guess which 
installer 
was built by 
Draginstall. 


gj*■ ■ installer 

Show Rooaiyfioftdttl hiUlkiloM 






0- 




Stirtup 


Sompl* leefu 

Tiitorul f Ilof 


0 




S 







Th* of nwtinittefi® To rtirt, 

OM w mof* of thMf fwtf uni te mv disk on tht right firtr 
the window. 


[ Bead Me ] 

[ quit ] 


Installer ; 


I Cuslem install ~ 


[ Read Me ] 


□ Dccumentation 
Hareglnstall EHtensions 
[R Draginstall Templates 

□ Semple Icons 

□ tutertai Flies 


WE 

m 
m 
m 
QQ 


Oltk tpjov vvotifrlr ; 
HoStlAatlM ' - 




__ ^ 

1 9 ,495IC sp*w nwM: ^20K 


P'rjBct OlsK ] 

[ SmUchOisle ] 


[ quit 1 



Guess again. 

If you guessed that Ihe first installer was 
built by Draginstall, you’re only half right 
Now with Draginstall 3.0, you can build both 
of these installers from a single script file! 

For more information about Draginstall 
and a free demo, visit our web site at 

http://www.sauers.com/tlraginstall 

or give us a call at 1-800^90-9880. 
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metrowerks 


Quick Tour: New CodeWarrior 2.0 IDE 


1 his past June, Metrowerks released 
version 2,0 of tite CtxlcWarrior IDE, The 
2.0 IDE is clicKrk full of new features. 
Now you can have multiple projects ojx.*n 
at liie siiine lime, nest projetis within other 
projects, and eitsily manajje multiple builds 
of the same project. 'lTiere;s a new MacQS 
Mer^'c Linker For merging 68K and 
PowerPC liinaries into Fat l>inaries, a new 
cDstomiZiible TcK)lbar, improved ilrag unci 
drop support and project File management. 
Lust but not least , this new version of the 
IDE is now multi-threaded and allows you 
to edit files, etc., while your project is 
f>uilding. Cool! OF course, this versirm still 
has an integrated souree cckIc editor and 
l>rowser. And it still supjxms plug-in 
compilers and linkers, an essential i')art of 
tile IDE's power and Flexibility. 

Uist montl), we interviewed the folks 
from the 0)deWarrior IDE teiim, Tltey got a 
chance to t:rf>w alx^nit their hivoriie features 
and talk alxnjt future directions. Tliis month, 
rd like to break with tnidition a hit. Instead 
of our regularly ^^ heduled interview, Fd like 
Uj Like a [irief tour of the 2,0 IDE. 

before we do, just a quick warning. If 
you haven’t already done so, take the time 
to read tlu^ very short dot'umeni tilled 
“URGENT KeudMe New IDE”. You II find !l 
on the top level of your CocleWarrior Tools 
CD, In addition to a brief introduction, the 
d(x:ument dlscu.sses is.sut^s relating to 1,7 
to 2.0 conversion, new features in 2.0, 
cemverston from Plauger/Flum Mull to 
Metrowerks Slandard IJhnary (MSI), and 
using the ol>so!ete ANSI libraries in MucOS 
projects. Where appropriate, “URGENT 
ReadMe New IDE” points you to 
dcx'umenls on ihc CodeWarrior CD that 
contain more detailed info. 


Also, lx: sure to spend some time looking over the new 
Preferences,,, and Target Settings... dialogs, as they liave changed. 
You1l tlefinitely want to spend some time in the Preferences' Key 
bindings pane w'hich lets yent taistomi?:e the key sequences 
atutched to various purt.s of the 2.0 IDE u,ser interface. 

A i]uick note of thanks to “BitHe'ad” Magnuson and Lkm 
Pod wail from Metrowerks who aaswered my pesky t|ut^k>ns and 
helped get this month's column up and running. Tlianks, guy-s,.. 


COINVI^RTIING YoDR EXISTING PROJECTS 
One of the first things you 11 notice when you use the new 
IDE is ifiat it will not open your older, 1.7 IDE projects, 
Eonunaiely, CodeWarrior Profes.sional (the nt-w name for the 
joint Mac and Windows release) includes a icxji called Project 
Ckmverfer which will not only convert your project.^ to 2.0 formal 
for you, but will merge nTiJliiple projects together into a single 
projea containing mulliple Uitgetx Tliis is inaedilily useful (and 
you 11 see an example of this a bit later in the columnX 

If you double-ciick on Project Converter, it will prompt 
you for a project fife to convert* Allernativciy, you can drop 
one or more project files on top of the Project Converter icf>fi- 
11iis will allow you to combine several projects into a single 
project file. One cla,s,sic example of this is when you are 
maintaining two versions uf the same jxoject, one for 68K 
and one for PPC. Nt>w you can combine the PPC and 68K 
projects under a single project with separate targets set up to 
generate the 68K build, PPC build, and Fat buiki. You might 
also want to set up target builds For debug and no-debug. 
Mulliple target suppnn is cotil. 

You’ll End Prcjjeci Converter inside the Metrowerks folder, in 
(he Other Metrowerks Ttxtls suliFolder on your liard drive 
(a.ssuming youVe iastalled il), 

A MuiTiPiJi Target Ex\mple 
Let’s lake a l(x?k at an example, I gntblxd FonnEdiL one ttf my 
t)ld Mat: Primer, Volume 2 projects, which I happened to have in 
IxXii PPC and 68K forma Is, just to see wlial wtaild iiappen, I titHible- 
dicked on the PK; EonnExlit projeen. Figure 1 sIk )ws ihe dialog iliai 
appe;tred. Cle^iriy, a trip to ProjeTt Crxiverter w^is in order. 
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Project FarmEdit (PP€}.|i must be 
conuerted, 

FormEdit (;fPC> 4 i tr 4 l^dfVsfrwr lOE 1 ^ projtot h &rd*r to 
050 it vith Co4tVirrfcr »E 2-Q^ y«i wed to Wflyort it vtth 
ttw Projtoi Convertpf . 



f#X'Mfv /. Tim mvmme ctp/)ears whenyoH try to o/nm u l,x 
project iisin^ the 2.0 fDii 

My next step wa,s to ccmihinc the CWll ami 68K 
honiiHdii projeas into a single mulii-targeij IDH 2.0 f>rt>jea. To 
do this, 1 Hrst selected h’ormKdit (68K).p and romiEdiE (PPQ.p, 
then dr4igged l^orh projects onto the Project Converter iet)n. I'he 
dialog shown in Figure 2 appeared. If 1 was just doing a hatch 
convert of a hunch of old projects, I’d t:lk:k the Keqo Separate 
button. Since I w'ant to join the projects, 1 clicked the Merge 
button. Project Converter prompted me for a new project lile 
name. I used the name J*ormHdit <Merged) 4 i. 


Merge 1,7 projects into multiple-target 2,0 
project? 


[ Cancel ] 


[ Keep Separate ] [[ Merge 


Figure 2. Project (kmmrter pmmpts you whether to comhme 
your old projects into one new one or conix^rt them sefmratefy. 

My next step was to doubleclick on the met>*txl pnijett to 
launch llte 2.0 IDE. A status dialog appeared (Figure?), dtsfdaying 
a series (jf messages a.s the (i8K pn>jeta was kxided, its files locatcxl, 
the PPG proje^a was loadcxl and. finally, its hies IfK’ated. 


— Opening Project ^‘FormEdit tMergedhu*" 


[Loadi ngi "FormEifit <60k>" ■ - 



Figure ? . Jhe status dialog that ap{mars as the project opem. At 
thLi IXtint, the 6HK ptx ject urn ioading. 

Once the hies aa" all locatcxl and ilu^ projetls kxtdc-d, tlie |>it>ject 
window appe-ars. At the top of ilie [>a)jcxt svijidow is a stories of tabs 
that allow you to explore various aspects of your projett. When the 
[)a>ject file first apjxrars, tlx.^ Pilc^ tab is .sc^letted, pasenling a meigcd 
list tjf all the filths that make np ytjur pajject, regaalless of target. In 
the Fikis view, a jxjfxrp a[)|X";in! at tlie top ot tlie window ihal allow.s 
you to select fajin the variotis taiget.s you liave set up. 


INTERNET 


SOURCE BOOK= ^ 
3 COMPLETE GUIDEBOOKS IN ONE! 

The Firft ^nd Only &ii5il!iiessn4A,lus[n£n Qh^ftory for 
tht fotcmet/InCraneC WorUTI 
Owr cisnipany lutings 4-104 

The Comiifotc Otilinc lhci|ifil^ng Guld* 

"Hic WebSlMi|jping gukk- liKiirig T.OOiU pile*, 200-t iiiticiijoriB 
Rnil chfl Tofi 2,000 CDrfwrate Webaitesf 



S 0 U 



If Has Anything to Do With Multimedia 
Chances Are You'll Find It Here! 

The Bii5ii3e^.LiwB«i5hi«$5 Dir«<Ce«y 
for tJin Holffoicdla Wbrfo! 
OviT 6)CXII ctVTfsiny ksui ilTV 
kcices} d» WorklX Top QitfJHy Supphen of 
Servkni and Equipment In Motfimcitja Today! 


The Place ta Find It! The Place ta Be Found! 


Hi-Tech Medio, Inc. 445 Fifth Ave„ 27 FL, NYC, NY 10016 
Tel: 212-447-6400 800-663-5421 Fox: 212-447-9177 

E-Maili info@hi-techmedia.com www,hi-techmedia.com 



At this point, IVe gta two largeLs sel up: !*PC and f>8K. lb 
switch Ixnwc^n targets, just select the targe! name fn>m the 
ptrpiip. Figure 4 shows the project window^ with PonnEdil ((>8K) 
selected. Figure 5 shows the prtjjcc.l window with PonnKdit 
(PPC) seceded 'fake a close kK)k at the second column in each 
figure. This is the column with the “toucherl/untouchetP red 
t:hcx kmark next to each filc‘ in the laigei. Since tlie project ha.s 
not yet Ixim built, this is a g<K>d indicator of which files are in 
which target. As yt>u can see, some of the projetT fikrs are usexi 
by lx Jill targets, others lx*long to only one latgel or the other. 



Figfinf 4 7l?e fmjject window unth Pormtklit ((^K) selected. 
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• Synchronize Modification Dates - Synchronizes the project's 
internal modification dates for each file with the file's actual 
modification date on disk. 

• Remove Object Code - reinovas objecLs from die current 
target of the active project. 

• Project Inspector - Brings up the Project (nspecior window, 
which allows you to edit properties of the selected files in 
the active project. 

Figure 7 shows two views of the Project Inspector 
window. The Attributes tab lets you turn on and off ailribuies 
like del)ug info, and the Targets tab lets you select which 
targets the file or files are pan of. 


Figure 5. The lm)pct wimlon' uith formiuiit (PPC) selected. 

lb build a target, just select it from Llie list and Make or Run. 
If I he IDH reports that it can’t locate some of your lihratics, build 
a new [irojeci that corresponds to the target yoLi are trying to 
build. For example, wlien I a in verted FormPdit, Code Warrior 
c:hokerl on the olti style MSL library names in iny 68K laiget. f 
built a new projett iLsing the Basic 68K Toollxix app stationery, 
then dragged the libraries from the ntfw project window into my 
FomiKdit project window, Tile user interface makes thi.s trivial to 
do. Ont:e you release the drag, the IDE will prompt you tt> select 
to wliidi UtrgeL you'd like the new files added. Of course, this 
technique applies anytime you add files to the project. 

Cool feature alert; What do you chink will liappen if you 
drag a file from die project window to the Finder's trash <^n? 
But of course — the file is removed from thc‘ project — Cool! 

The Boitons at the Top of the Project Window 

Just to the right of the target [K>pup menu ar the top of the 
projeii window is a series of 7 buttons < Figure 6), each of wliich 
performs a separate function. From left to right, here's what each 
of these buttoas do; 


_= 

m FormEdlt (Merged).M m 


1 LinkiOrtE^ 

Targptr 

[ 



1 

^ rarmEdit trtpdl' 

2m 


rial 

H 1 


Figure 6. The 2.0 IDH includes a set of 7 nsefui buitom at the 
lop of the project window, jusl to the r^bt of the target popup. 

■ Target .Sellings - Brings up tlie larget Settings dialog. 

• Bring Up To Date - Compiles all mcxlifiecl ami marked files 
in the current target of the active laiget, 

• Make - Compiles and links all modified and marked files in 
the current target of the atiive target. 

■ Riin/Debug - Does a Make, llien runs the executable. 



Figure Z Ttm vietm of the project inspector, showing the 
Atlribuk^ and Targets panes. 

The Link Order and Segments Tabs 
'Ihe second lab in the project window says either Segmenis 
or Link Order, depending on the target. In a 68K project, the 
Segments tab allows you to manage your project's segmentation 
(Figure 8), You can create a new segment (an item ap[^ears in 
the Project menu), reorder files and segments, or drag files from 
one segment to anotlier. 

’Ihe Link Order tab (Figure 9) lets you use drag and drop 
to change the link order in a PPC taiget. 


— Fnrmlidil IMerqedl.a 



m 

1 FtIit I 




.i. c>«*i 

■ami'# 


-7^0 Swircva 

a 

0 * 


<> 

^ B Fu-mE^ t 

0 


@1 


¥ ^MSLC**£&^ FiC4LJ9d)l«> 

0 

{] 



<0- ^ hfatHLOfeeK Fi<4fJ640 

0 

a 



V' ^ MSL .Lb 

0 

0 

@ 


0- ^ MSLt mi 

D 

Q 

Q 


7 iQ j^rHwoes 

0 

Q 

m 


0 gL, ferfflEdtt.il JTTfl 

n/e 

n/M, 

m 


7 Q Libr^rWt 

0 

0 



0 ^ MkOS hb 

0 

0 

m 

' 


7411k 

o 

Q 




Figure fi The Segmenls tab, which apfxfaTs 
when the current target is 68K based. 
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1 Files 1 . , 1 raraets | 

ftF,rtrtE4itfp^ ’ a vliil il 


1 *^ B FftrmEdii.c 0 0 • S 

iff ^ FcimnEdlt.Tf rsrft n/a n/a 

0 ^ InterfaceLl] 0 0 0 

0 ^ MathLib 0 0 0 

ef MSL RurtfmePPClib □ 0 0 

^ MSL CPPCHj 0 0 0 

^ ® MSL C++ PPCiib 0 0 0 



i 

7 files 0 0 


Figure 9. ‘Ihe link Order tub, which tt{)()ears 
when the currmi target is PPC-hased. 


Crmting a New, Fat Target 

Tlic‘ last tiling we’ll do is create a new, fat target. I'irst, click 
on the target tall in the project window, '['hen, select Create New 
Target from the Project menu, "When the New Target dialog 
appears (Figure lOJ, type in an appropriate name (such as 
"ForinEdit Fat") and click OK. 


Neiu Target 


Name for nev target: 


FormEdit Faf| 


P^.Nev target containa: - 

^ Empty target 

Clone existing target: 


FgrmEdit^t^Sk) 


Cancel j 


OK 


figure Id 7he New Target dialog hox. 

When the new tai^et appears in the target list, double-click 
on it to bring up the Target Settings dialog. In the Linker y)Opup 
menu, select MacOS Merge. Next, select Linker/MacQS Meige 
from the scrolling list on the left side of the I'argei Settings 
window. Type "FormEdit (Fat)’’ in the File Name held (feel free 
to till in the Creator field as well). 

Click the Save button, which will bring up a dialog telling 
you the target must be relinked. Click OK, then dose the 
Target Settings window. 


The last .step is to create dependencies between the Fat 
target and the PPC and 68K target, so that when you tell 
CodeWarrior to build the fat target, it makes sure the 68K and 
PPC targets are built. To do this, click on tlic 68K target and drop 
it on die Fat target (you1l want to drag a little to the right so it 
appears as if the drag was slightly indented). Now drag the PPC 
target and drop it on the Fal taiget. Click on dtc disclosure 
triangle to sec the resulLs. 


F^mlEdit (Mergedku 



figure IL We Fat target with its tiw dependencies. 

Next, click in the link column (far right of llie project 
window, Targets pane) of both dependent targets to tell 
CodeWarrior to use the output of both 68K and PPC targets at 
link time to create the Form Edit Fat target, A black dot will 
appear in the link column to let you know you did the right 
thing (Figure 11). 

Next Montiu The Java Interview 

I wish I had more pages to work with, as weVe only 
sciatched the surface of the 2.0 IDE. Perhaps in a future column, 
Fll tackle a more complex example, widi subprojects, plug-ias, 
etc. Till then, it's back to the interviews. Next month is our 
special Java issue and well be talking with the CodeWarrior Java 
team. See you then! K1 


Want to know what products 
are available for MacOS 
development? Check out 
Developer Depot^"^ 
<http://www.devdepot.com> 
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TOOLS OF 
THE TRADE 


by Paul Robicbaux, 



Spotlight: Illuminate Your Bugs 


Memory protection, trap 
parameter checking, and 
leak checking 


iM'iioDiJtrnoN 

Generally, Macintosh development 
lools stand up very well to their 
a>unteq>arLs on other plalforms — with one 
exception. Until recently, the Mac lacked a 
c'omprtrbensive debugging tcx)i to compare 
with IkiundsChecker h>r Window.s or Purily 
For Unix. These* prodiicis — tiiudi ix:ioved 
by developers on other piafforms — 
generally offer thnee classes of servicers- 
memory [iroteclion, parameter chet'king For 
system APIs, and leak detection. While their 
implementations differ, they generally don’t 
ret|Liire any changes lo the soiirce ccxle and 
can be used throughout die devek>pmeni 
pnx'ess to trap olfending ctKle betbre it is 
refeired to QA or user testing. 

Of course, the Mac Ux>lbox firesents a 
mimlx'r of opportunities for doing Bad 
Things in your c<Kle: writing in other apps’ 
heaps, dereferencing a handle aller it's 
been mewed, and forgetting to dispose of 
dynamically a Notated resources are three 
[xrennial favorites. A tool whicli could 
detect these, and other, errors would be 
valuable indeetl. Wliile there are prfKliicts 
on llie Mac which offer one or two of 
these services, no one has yet combined 
all ihree into a single, easy-tn-u.se 
package. S[)otlight, called by Onyx 


Technologies an “automatic memory debugger,’' provides ail 
three servk:es in a robust, easy-uvuse package. 

What Spotijght Does 

Spotlight is designed to be Rm as paur of the development 
[irocess. When you nm it, it loatLs your executable, makes a C'opy 
of it, and patches tlie copy to inscM t ils watchdog code. You don’t 
have to modify your source code (except in rare cases as 
described below) or even relink! 'I'he watchdog code drat 
Spoiligtii insens will cause an cxccptkm to occur when your app 
does something it's not sup|XJsed to; Spotlight wiil catch the 
exception and show you a wintlow detailing die offense (see 
Figure 1.) In this I deliberately called InsetRedO with a nil 
pointer. Notice how Spotlight not only flagged the error, Imt told 
me what Td done w rong, 



figure L Spall's enor rep()rimg windouK 

Spotlight offers three types of debugging services: memory 
protection, leak detection, and Toolbox call validation. Let’s set- 
how Spotlight provides eaclt class of service. 


Paul Robkhaux iruisr lx* tim kiekiest guy alive — he gets paitl lo write Macintosh ciyptography and security software l>y day 
and siili nianago-s to have free time to enjoy his family. He welcomes your ccaiimenis via e niiiil to paulr@hiwaay.net. 
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Memory Protection 

Unix jmcl Windows NT both offer per-process memory 
protection. If a prcKCSS tries to acc'ess memory tjutside its t>wn 
ackjres,s range, an exception <H:curs. Tlie ojKTaiing system traps 
these exceptioas and stops the offending process. While not 
perfect, per-prtK:ess [protection usually keeps one ill-behaved 
application iVoni trashing others — as fretiueriily hap)x-ns on 
the Mac. 1'his same sort of coarse-gniined protection was 
planned for Mac'OS 8; in the meantime, tlioiigh, System 7 
doesn’t offer any DSdevel memory protection. Sjmllight checks 
every read and write instruction before executing it. If your 
application tries to ;u:c:e.SH meinory in a heap owned by tlie 
system, or another apjdication, Spotlight stops it and displays 
the (pffending source line and adtlres.s, as well as the contents 
o]‘ memory at that address. 

In addiiion ttp inleqprocess memtpfy protection, .S[XJtliglu also 
watches memory inside your appliaition's heafi. If you try to use 
a handle blcKk after freeing it, or write past the end of a stack 
variable, Spotlight will caich it and warn ycxi immediaiely. 

Leak Detection 

If Isaac Newton liad lived in the time f)f digital computers, 
his First Uw might well have s;dd ‘‘For every alkx:aiion, there 
must l>e an equal and opposite tlealloeation." Unfortunately, this 
law is often recalled in the breach — ifs all [i>o easy to tbrget 
that call TO delete, DisposeFlandle, or ReleaseResoorce. When you 
all(K:aie something and forget to free it, that’s a leak. Resources, 
handles, Macintosh or C pointer blcxjks, and objects can all 
lx‘ leaked. Spotlight will detect leaked hhK'ks, handles, 
restpurces, and tpbjects and display them in a summary which lists 
the bkxk size and a stack trace of tlte code which allcK^ated tf. 

I'tHilhox Call Validation 

In an ideal world, your ctKle could [Pass any kind of gartpage 
to a Toolbox remtine and gel a useful error ccxle or extepiicm in 
return. In practice, passing invalid piirameters to TcxpIIxpx 
routines is easy to do Iput hard to detect — most often, these had 
[Parameters result in buried mislK^havior that surfaces, like a great 
white shark, \o l)ite yc»u when you least expend it. S[x>iliglti does 
a pre-flight check on arguments to alxput 'RXl different 'IVkpHxpx 
routines; if you pass in an invalid parameter, ycnfll get a warning 
indicating which parameters nnd which 'IikpIIiox call arc^ sus(k\i. 

.S[KHlighl also checks tor rescmrce-iiandling errors by 
ciiecking the value of ResError after each Resource Manager 
call; I ccpnsider this as extra TcK>ilx>x valitktlton, so 1 won't 
discuss it separately. 

At this [xiint, you might be wotidedng how Spotlight differs 
from Onyx's QC; after all, they’re Ixith debugging UkjIs and seem 
to have a lot in common, 'llie two prcKlucLs cotnplement each 
other. QC runs on 68K machines; Sfxidight diKfsn't. Spotlight can 
detea memory and rc'source leaks; QC ain't. ik>ih offer some 
memory [Protection ami Toolbox call validation features; 
Spotliglit's implementation is more complete. QC was designed 
as a stress-testing ux)] — Ipesides its debtigging features, it can 
automaik^ally scramble, purge, and free memory and restpurces to 


SmalltalkAgents* 

Integrated Development Environment 
for 

Macintosh 
Windows 95/NT 



Check out what's new... 

www.SmalltalkAgents.com 


n 1/ 0 street 

K A P.O.Box 371478 

Montara, CA 94037-1478 USA 

C Quitsr KwwieciQ# System*, Inc. 1&97 
VWidawi K ind Wifidcjwif NT ar« Trademarits of 


heijp you fmd subile errors which only show up under low- 
memory cnntiiiions. Spotlight is designcxl as a day-in-atxkduy- 
out debugging Ux>l that you use in parallel widi ytJur compiler, 
linker, and stpurce-level debugger 

Pi.tir.(aN(t IN riih Light 

Spotlight i)R1 ships as a single PowerPC binaiy; it only runs 
on PowerPC machines. Besides the SiTOllight application itself. 
Onyx includes a co|>y of Apple's PowerMac IXdpug Serviceii 
debug nub and a 6-page elcttronic manual in .self-roiiiing 
dtxument (SKD) format. During installation, you have to provide 
the serial numlier included with the package; once you've done 
that, you'll he able to run SpotligiU on your applications. 

To use Sporlighi, just launch it and open an .xSYM nic; you 
don't have to rectPtiipile at mlink your ajpplication unless you 
need to use S|X>tlight’s API rotiiincs, which let you turn Spillighi 
on anti off in critical sections of your ccxie. The Alh itself is very 
simple — only 5 loutines — but mtisr applications won’t need it. 

S|K>tliglu copies your extxaitable and patches In its own 
routines lor inspecting memory alkKUiion, warc'hing for leaks, 
and validating T(xi1Ik>x parameters. 'Ihis paLcliing process takes 
a noticeable amount of lime (alxm! 6 .seconds for my app on an 
8100/100 with 32Mh of RAM), but you can sfx^ed il uj> by first 
copying your App and .xSYM hie to a RAM disk. 
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for the Macintosh- 

The Industry Standard for 3D Graphics 

Port your code from other platforms with ease! 

Workstation Class Performance on your Mac 

Complete on-line documentation and support 

All common support libraries provided 

Multi-processor capable 

UNIX or MKLinux versions 

Works with most compilers, including CodeWarriot® 

Callable from C/ C++, Ada and FORTRAN 

Full Technical Support 

Custom Libraries available 




Conix Graphics 

. Download free demos at: 

www.conix3d.com 

Let your imagination fly! 


Sales Technical FAX 

800.577.5505 817.467.0461 817.467.9452 

sales@conix3d.com 

A1 trariemarks r^maih the property of iheir respectfvt owneiii. 



Once Spotlight is Hnished patching your appliotion, it will 
launch and run normally — aib€i[ slower than usual. You can 
use your app just as you would while running in a source- or 
low-level debugger; when Spotlight delects an illegal access in 
your code, it will display its reporting window so you can see 
what's wrong and choose what to do about it, In addition u> 
tiigliiighiing the offending instruction, Spotlight will also tell 
you what fault it delected* (Note that SpoLlighl doesn't stop for 
leaks, since it can't tell wiielher an allocation is a leak or nc5t 
until you stop the program.) 

When the reporting window appears, you can use 
commands in the Debug menu to control wliai Spotlight does: 

• Ignore (-I) will (mtse Spotlight to pretend tliat ii dkin't see 
anything amiss and coniinue executing your prcjgram. If 
Spotlight catches something that's not really an error (say, 
when you call Get 1 Resource() to see if soiuediing exists), you 
can use this button to skip over it. If the entjr is rcul, you 
ignore it at your peri], l>eeause your app can still crash while 
SfXJtlighl’s running* 

• Ignore Address (-A) works like Ignore, but it tells Spotlight 
to ignore any error generated by the source code addres^s 
Ixing reponed. This is useful if you're doing something in a 
loop or a frequently called function that's not really an error. 

• Ixig (-L) teUs Spotlight to log the error to its log file, which 
is named "Spotlight Log’' and lives in the same folder as the 
application and symbol hie you're debugging. Eacit log entry 


contaias the cause of the failure and a stack trace pointing to 
the offending code* When you use tlie Log command, 
Spotlight continues execuLing your program — if you log an 
error that can cause your app to crash, it will crash after the 
log entry’s written. 

• Kill (-K) stops your application* This is often the safest course 
when Spotlight catches your code writing trash in another 
process's space. 

• Display Memory and Display Variables show the Memory 
and Variables windows, which display what you'd expect 
them to. One nice touch is that Spodight draws suspect 
memory addre.sses in the Memory window in gray, so you 
can easily spot tliem. 

• Re?iet l^ks resets the internal leak counters; you can use 
this to make Spotlight forget about leaked ol>jceLs fn>m a 
previous set of operations (for example, if you're testing leaks 
when opening documents.) 

• Dump Leaks saves the current leak report to a log file; in 
conjunction witli Reset lx!aks, you can easily get leak data 
for one particular ctimmand or action in your application. 

• Debugger (-D) drops you into whatever iow-Ievel tiehugger 
you have installed. From Macsbug, the G command will 
return you to Spoiligfil* 

When you're done running your application (citlier because 
you quit it or because you used Spotlight's Kill command), 
Spotlight balances ils recorcLs of the memory and resource 
alkx:ations and deallocations your application's made; it will then 
present a window sfiowing you what it logged. See Figure 2 for 
an example log window. 



Figure 2, The S(x)Uight log tmidow. 

The log file is written into the folder which contains the 
application and *xSYM file. The first time you run Spotlight on 
an application, the log file will l>c named “Spotlight Log"; 
subset]uenl logs in the same folder get a number at the end of 
the filename, so you can separate log files from different runs. 
In a welcome concession to editor religion, you can specify the 
ty[>e and creator used for log files so they will aulomatically 
open in your preferred editor. 
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The number one AppleScript environment 






, For professionals, 
for novices, 
for webmasters, 
for solutions providers: 

Always the most powerful, 
the most feature-packed, 
and at the same time, 
the easiest to use. 


There’s only one serious choice. 
And it just got better. 


. IVs already the only tool that lets 
: you watch local variables, trace 
variables, or change values and 
fix problems while stepping. 


Now, Scripter hits version 2.0, 


Handler debugging: 


Applet and CGI 
simulation: 


Live editing: 


Object Map: 


with still more 

Dehug handlers without modifying your scripts. 
Interactively debug live ii 


unique features: 


plication me.s>sagcs sent to a script 

an applet, your Web server or FaceSpan 2.x. You won't have to mod 

Debug script applications and CGIs in their normal environment. 
Explore a graphical view of the class hierarchy of .scriptabic applications. 


application or AppleScript CGI from 
loclify your Web pages or your CGIs. 



Plus: 


Integrated object 
database: 


Construct generators; associated terminology; search backwards; faster searching; more navigation tools; 
makeup oi AppleScript strings; fast compile (without debugging); even morcaSM^ced trace log; and more. 

[ ScriptBase, separately $59, is now included with Scripter. Use it to store your^data afidmlfedcmcnts 
[ (frequently uscxl values, scripis, text, pictures, HTML, headers, file refcrcnccspfld;§hafe i 
cript-s. Manage ScriptBase mrectly from Scripter. 




£uv at 

\nvw.maineventcom 

or order, toll-free 

1800 6l6 8320 

info 

+1 202 298 9595 

email 

info@maineventcom 


■ Tf you’re an AppleScript novice, 
ISctipter will take you by the 
' hand and show you the correct 
: syntax for your statements. If you 
- know what you’re doing, Scri^er 
will help you do it faster than 
any other editor. And Scripter is 
the only tool on the market with 
interactwe You atch 

the offending code in the act. 
Only Scripter lets you fix the 
problem and continue debugging! 


Wc designed Scripter for 
productivity and user-friendliness. 
People come to us for Scriptefs 
indastrial-strcngth debugger, but 
what reallv impresses them is the 
speed ana ease at which Scripter 
allows them to work. It’s been 
used to build major corporate 
process automation systems. 

Scripter offers power-assisted 
statement construction. Vcxabulary 
access in a single mouseclick. 


Multihinctidivfmd'and replace. A 
variable watcher and expression 
evaluator. Tools to change variable 
values or try out commands, in 
context, in tnc middle of debugging. 
Automatic navigation to subroutines. 
Background processing. An 
enhanced trace log. Extensive Drag 
and Drop support. We could go 
on, but we just don’t have the 
space here. So gel a copy today, 
and start saipting with power! 


^ — 


V)eMacM(jsh Scripting Company 
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High Performance 
Imaging and Annotation 
Development Tools 

RasterHtsster €.0 - Familiar API and welJ-proven technology In use 
world-wide by companies such as British Petroleum, Chase Manhat¬ 
tan, Eastman Kodak,. Filenet, ford, Gannett, Kewtett-Packard^ IMSt, 
Lexis, Philips, Polaroid, Siemens-Hixdoft, Trix, Unisys, and Xerox. 

50+ Raster Formats All TIFF, jpeg, GmupS, Group4, MO dca 
lOCA. CALS, PNG. PCX, BMP, GIF. PhotoCO, ABIC, Flashpix and mofeJ 

RastcrNote^annotation/mdliniiig toolkit - indudes all popular features. 
Create Sticky Notes, Freehand Drawing, Lines, Ellipses. Polygons. 

NEW ADDITIONS: RasterNote, UNIX. Alpha. Flaahpix 
Formal Peadir^. Saving, Compression. Display, Despeckie 
Rotate, Zoom. Pan. Scroll, Deskew Anii aliased display, 

ALrto aspect ratio, Image prooessirvg, Transparent colof 
Improved Twain scanning. Color reduction and promotion 

Platforms Wirt 95. Win NT, Win 3 1, OS/2. Alpha, Macintosh. UNIX 
Environments: DLL, VBX, OCX/ActiveX, Delphi. VB, PBuilder, VC ++ 

Call 617 &30-S4S5 of see ourVy^bSite for NO RISK EVALUATIONSI 

WWW, s nowbnd. CO m 

PO Bojt 520 Nowiqn, MA 02159 Tel 617 630^9495 Fas 617 630-0210 
Email saiesmo@srKwtxxl com 

SKOWIIttl^aSM 

sM»FnrwAue.» 

.Sffjiware - ^werfiit, Fofif, Retiahie 


Once youVe reviewed tlie file conientN, you niu.st quit 
S[K)ilijrlH l>efore you am am U again; liiere’s no way to re-mn a 
program, wfiether or not it's lieen relinked. 

Working Wfih SpoTiJc;eT 

For the most part, S[X)tlight is an cxirenicly unolnaisive 
addition to the deveU)fimenl prcKe.ss, You don't have to link 
wiih any special libraries or make any c'hanges to your .source 
crxJe (except as noted Ixdow,) You must run il in phic:e of a 
source-level debugger (it might work with Jasik’s debugger, 
bur 1 don't have it and didn’t lest tr), so it's not the best tool 
to use when you're looking for control-How or processing 
errors. I found that the mo.st productive way for me to use 
Spotlight in my worktltw was to rim it after 1 was s;iti.slied 
with die overall behavior and [xrrurtuance of my code; il 
serves as a la.si hurdle (along with Onyx's Q(" Pro) that my 
ccxie has to pass before it advances to QA. 

Yt>u have some contrt>l over what Sfxalfghr checks; the 
Options dialog, shown in Figure 3, allows you to turn each of 
the four primary test categories on or off. At present, litere's no 
way to turn individual tests on or off; for trxample, you can’t tell 
Spotlight to check allocations made with MacOS calls l)ur to not 
clieck allfxations made witli malloc() or operator new. 


Test Optiom 


A 

Test N,anie 

Category 



Validate Read/Write 

M^-mory 1 

A 


Report Rsre F^fkjres 

Logging 



Report Memory Loaks 

Logging 



'oolbox Validation i 

Validation 



Logging ^ ] 

Preference 



▼ 


>-X 

Cancel j 

OK 1 


figure 3 ^ Spoliighl 's dialog. 

Bec'ause of llie way Spotlight patches your ap[>Iicaiitm, you 
may have to make some tiiinor < hanges to keep things running 
srntKJthly. The dcxu mental ion warns diat Spotlight will crash the 
machine wlien il caTches an error in an inleitupl liandler routine 
unless you've bracketed the routine with calls to the 
SLEnterlntermptO and SLLeaveInterruptO routines. Spotlight also 
oflers two rouiines lo pnigruinmatically turn ii un or off. You can 
use SLEnabieO ami SLDisableQ to bracket code sections which 
trigger false alarms in Sjxaiighi, or where performance is critical. 

I'hesL' interfaces are provided a.s C and Fa.scTil header files, 
so you ran nil them from C, C++ Pascal, Object Past:al, or any 
other language whitHi tan import either iy(x* of declaration. 

IXk IIIVIENTATION and SliPl*ORT 

SiTOtlighl ts Llelivc‘R‘d tHcxtR>niGilly; unlike its sister [>kkIucI QC, 
there's no aiirent way to gel a physiral t'opy of ihe pttxlucl. Onyx 
will sliip physinl pitxlua free of cliaige lo all puixiuisciis of the DR 
refrasL'S once die final veision ships. Ilie Lllstribuiion mliive awnes 
wjih a (Fpage ,seif-mding tkx umeni. Hie ixitl news is that Ms 
doiinneni Ls very shtirt and contaias relatively little information on 
lujw to U.SC Spulighl. The gcxxil new.s is lliat Sjxjllighl is easy enough 
to LLse tliai the skimpy dtxs aien'i a hindmixe. Ik-tter still, Onyx 
[>n)niises a more sulisianiial [irintc-d inaniial for the llniil release. 
Having s;ik] lliai. one item that I ixiiticularly missed was a list of 
whkh llxjllx>x r<iutioe.s Spxligiit t“an do pirameter clKxking on. 

Onyx provides kxhniral supp<5rl to n.sers via c-mail and fax; 
ilK'y a 1st) maintain WWW and VW sites with ujdales and piichn. 
Onyx Im earned a refxnation for excellent .support of ttieir QC 
[>rtxluct, including j^roviding free pakihes and updaters on their web 
site. Ttie t|uesttons and comments ! sent in during my evaluaiion 
weiv pnantitiy and courteously answered. One piiticularly nice 
touch dial other vendiHs slnjuld emulate Ls Onyx's maintenance of 
a mailing list for itpgrack" and rctcuse announcements. Onyx also 
mainittias an active presence on Hsenet, 
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Many development tool vendors have moved away from 
irregularly seheduled point releases and to a subscTiprion 
model. Onyx has adopted this ap[:>rt)aeh for Spoilight If you 
buy Spotlight now, youH get whichever developer release is 
currently shipping. As of this writing, that would be OKI, but 
by tlie titne tliis reaches print DK2 should be shipping instead. 
Wlien Onyx releases DR3 and the final 1.0 version, anyone who 
purchasetl DRI or DR2 will get them automatically. 

Spotlight lists f()r US$199, but it’s available for $M9 to QC 
owners, or you can buy the two products together for $248. 
Brxause the physical version isn’t shipping yet, it’s only 
available directly from Onyx, all hough other distnbinors 
(notably Developer Depot) will be selling the release version 
when available. 


Spotught Limitations 

'Uie DRl release docs have a few rough edges and 
limitations. Let's deal with the limitations first: most significantly, 
you can only use Spotlight on PowerPC applieatiijns. If you’re 
writing code lor the 68K, or writing ctxle resources or shared 
libraries like Component Manager components or Photoshop 
plugins, ^Spotlight won't hclf> you at present. Spotlight rei[uires 
a .SYM“forinat symlxil file, so your dcvclo[imerU cnvironnicnl 
must he able to genemte one. 

Spotlight dex'sn't integrate with the Meirowerks or Symantec 
debuggers, so you can either debug your ctxlc or Spoiliglit it at 
any one time. Onyx has promised tetter integration with 
MWI>t4xjg as their #1 future priority; the two companies did a 
very nice job of mlegraling Onyx's QC and MWDebug, ,so let’s 
hope they follow through on this as well 

As might be expected with a DKl prfKiuct, the user 
interface is not as pt^lished as a final release product; you 
can’t cut or copy text from the log window, and the Close 
command doesn’t close the log window. Some little touches 
would ease the daily process of using Spotlight. For example, 
it would be handy to open a source file in its creating 
application by double-clicking it in Spotlight’s .stack trace 
pane, and it would be useful lo he able to attach a note in 
the log file when you use the Log command. 

Is It 1V1a(;k:? 

The first Few Eimes Spotlight flushed out camouflaged 
defects in my ccxle, 1 couldn’t do anylhing but smile. Every flaw 
that a tool like Spotlighi finds is one flaw^ that my QA team, teta 
testers, and end users w'on't have to deal with. In that sense, it 
really is like magic 

'fhe magic comes at a reasonable cost, too. You don’t have 
to learn any arcane commands to use Spotlight, and the 
majority of applications won’t rettuire any changes lo take 
advantage of its defect-finding abilities. Despite the fact that it 
can’t debug anything but PowerPC applications, Spotlight is a 
valuable tool which I liighly recommend. At US$199, it’s a 
bargain compared to the amount of time you can waste hunting 
for bugs which can be Spotlighted in minutes. 


Wliere should you go 
for an installer today? 


Microsoft went 
to MindVision 
for Office 97. 


Miemsofi’s upcoming OfGcc 97 for Madntosli uses Installer VISti by MindVision. 
Miot^soH Adobe, Mem>vwrkx Macromedia—major s(^iwarc companies araimd 
ihe vifiM txjfne to MindVision. So if ytxj wiint an installer and technical .support 
Hiai f:aji go tlx distant^, make your duHce tnsiallcr VISI3 


wuiniu. mindvision .com 



MindVision I 
Software 


40a.477.3aS9 
Fax: 402.477.1395 

sales @ m indvision. com 


3-^ 


Mac'OS 


DesigntKi lor 



Microsoft" 

ViNndowsNT' 

Window^ 


lWLTiitsi:4i. Tiihkw^ Wndoti^ NT, UAi: 0^, Mob#, 

MuTiiiiHvliu an’ (.iC iiwr wsiptHJiwdiwFjan. 


Product Reviewed in this Article 

Spotlight Onyx 'I'echnology. 7811 27th Avenue West, 
Bradenlon, FL .M209. (9h) 795-7801. 


Useful URLs 

<http://www.onyx-tech.com> Home page For Onyx Technology. Bl 


Want to know what 
products are available 
for MacOS 

development? Check 
out Developer Depot" 

<http://www.devdepot.com> 
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Rhapsody Brain Dump 


What did Apple have to 
say about Rhapsody 
at WWDC?? 


Rhapsody at WWDC 

Once a year, Apple hosts the World 
Wide Developer Conference. Developers 
from all over the globe come to Cupertino to 
learn what Apple plans for the next year. In 
tlie past, Apple wanted to show' us their 
technologies as early as possible to get our 
feedback as well as help us prepare our 
products for the new technologies. 
Unfortunately, after the developer feedback 
and market realities have settled in, what 
Apple showed doesn't always make it into 
die marketplace. This has left the developer 
community a bit jaded towards Apple telling 
us aboiu new technologies at WWDC. 

This year, however, was different. 
Apple had only one main message, and 
tliat message Is iftiapsody, l^st Dexember, 
Apple purchased NeXT, f)ut everything else 
on hold, and lias lx;en working day and 
night to integrate their new technology 
with the existing MacintOssfi OS that wc 
Itave all come to love. The teams were 
meiged in the first week of Febniary, so 
Apple wa,s really only able to talk about 
what they have done in the la,st 5 months. 


What did Apple have to show for only 3 months work? 
They showed a lot. They showed Marathon running on a 
diskless Macintosh computer booted over a network. They 
showed OPENSTEP with the start of a Macintosh look and feel. 
They talked about what will continue to work and what will 
break, and for the most part, everything will continue to work, 
as long as the software is not patching low level routines, or 
directly messing with hardware. 

However, Apple also projected a huge reality distortion 
field. Even though they had been working on this for only 2 
months, the level of excitement at Apple had people believing. 
They showed things running, and developers, including me, 
were willing to believe that anything's possible. You should 
remember that after WWDC developers sometimes don't think 
as clearly as they should. 

Rhapsody Technical Overview 

Rhapstxiy is the mature NEXTSTEP foundation — Mach, 
OPENSTEP, BSD UNIX, and Distribute Objects — mixed with the 
industry leading Apple technology: QuickTime Media Layer, 
ColorSync, and AppleScript. Rliapsody will also include other 
cutting edge technologies, such as EOF, Wel>ObjecEs, and Java, 
Rhapsody is still developing, so more technologies probably will 
be added over the next year. 

How does Apple plan on putting all this together? 
Figure 1 shows the Apple Koadmap ro Rhapsody, but what 
does it mean? 'Hie boiiom box represents the hardware. That 
currently can l>c either PPC or Intel chips. For the vast 
majority of programmers, the hardware chip is completely 
irrelevant because the Core OS layer above the jiardware 
entirely covers the Ijardware. 


Michael ICutnmn <ni(X)se@maniciiu)os<;;,t;um> is a software developer with experience developing For several platforms, 
including Macintosh, NeXTSTEP, Newton, Pilot, and Windows NT Wliiie wt)rking at Sriftware Ventures, he lead the 
development of Snatcher and MiemPhone ?ro for NEXTSTEI* He also worked on die MiooPhone Pro For Macintosh produa 
line. He now works as an independent consultant on a variety of pmjecLs induding encryption, compilers, web based add- 
rotation software, and ship .stevedoring. 
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Rhapsody 


Advanced Mac Look and Feel 

Mac OS 


Yellow Box 
OPENSTEP based 

Java 1 

Core OS: Microkernel, I/O Architecture, File System... 

Power Macintosh, 

PowerPC Platform Hardware 


Figure L The Apple Roadmap to Rhapsody 
from the DevWodd u^b site. 


Core OS 

The Q^re OS layer ainasts of Mach, a BSD implemeniation, and 
a plugin driver architecture. Mach is often confused with untx, but in 
reality it ts a micro-kemel. The Mach code consists of a mete 35 
thousand lines of code out of over 6 million lines in Rhapsody, The 
Mach micro-kernel contnAs the Virtual Memory, Tasks, Threads, 
multiple processors, and incer^application communication. 

The BSD implementation is a ftiUy compliant Unix witli Posix 
extensions. However, many MacinUxih users have come to fear and 
loath tJNDC, Well, imybe not fear and loath, but few Macintosh users 
embrace LrNJx, and don't want to learn undc tools to get their jobs 
done. Fortunately, Apple recognizes this and has hidden the undc 
layer near the Ixittom. Most usen; will never see the untx layer, and 
better yet, most developers can ignore the undc layer. Best of all, if 
you like UNix, It's there and is accessible. 

The plugin driver architecture was created because of 
OPENSTEP for Intel, In the Intel market, NeXT had to lie Me create 
new drivers quickly. Every month, there were new drivers to port, and 
few of the hardware manuhictuieis would standardize. 'Ihe Rhapsody 
team is working very liard on Lliis. In additi<jn, because this Ls a Mac, 
Rhapsody is also promising true plug-and-play. 

For most people, users and developers, the entire Core OS 
is hidden behind the next layer, which is either the Blue Box or 
the Yellow Box. 


What is the Bute Box 

Neither Apple, nor die developers, are prepared to abandon 
the thousands of applications already created. Many of tliesc are 
legacy applic:ations, which will continue to be used for many 
years, Apple is creating what diey call a compatability layer, ccxle 
named, “Blue Box"* 

The compatability layer consists of the MacOJi, the Finder, 
Toolbox, extensioas, whatever coirrently runs on your Macintosh. 
Apple plan to take all of this code, and turn it into an OPENSTHP 
application. Tliis application, running under Rhapsody, will run 
almost all existing Macintosh software. 


P^ton 

PowerPlaiit 

J 

v O 

^ SYMANTEC 

AppMaker supports most popular languages 
and frame\TOrks. Just point and click to design your 
user interface, lltcn let AppMaker cremate resources 
and generate “human, professional quality code" 
to implement your design. 

Use AppMaker as a prototyping and 
productivity tool or use it as a learning tool 
for Mac programming techniques or 
for new environmeiits such as 
OpenDoc, Java, or Pow'erPlant. 

AppMaker is just $299 and includes a 
one-year subscription on CD. 

B*0« W*E.R*S 
Development 

603 - 863-0945 

bowersdev@aol.com 

http://members.aol.coin/bowersdev 
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I low cm A(>ple lio this? Isn't there a huge difFcrenee [Klwccn 
an OS and an rippltration? Atiuully, there isn't. Both are written the 
same way, lx all aa^ launehetl the Siime way, and lx>th tan do the 
same tilings. An OS is usetl lo laimch other applitaiioas, hut many 
applications also do tliis witli a pIng-in architetlure. Tliere Ls very 
little difference IxjLween how Netscape uses helper application.s 
and an OS launching an appliattion. 

Apple Is planning on pre.seniing users witli 3 ways of ainning 
the Blue Box: a single window for all Blue apps, Blue apps using all 
of the soeetis, and dual Iwit. As eadi users neetis are differeni, 
Apple Is kxiking at a variety of .solutions to lx.-si serve their users. 

'ITie single window inode is best for those users that quickly 
migrate tti Rhapstxjy, but want to continue ruiining a few older 
applications. These older appliDiiions, called Blue A[>ps, all 
apjx^ar in a single Rhapsody window with the Blue liox menu 
bar. Tf two Blue Apps aie running, their windows appear in the 
same Blue lk>x window. Rhapsody applications ctmtimie to l(M>k 
and act like nonnal MacinKxsh applications. 

'file setond m<ick% where the Blue Box takes over the 
screen, looks like a tniditinnal MacOS 8 machine, hut lias 
Rhapsexly running in the background. Rhapsexly applicalurns are 
nor able to interact directly with the user, but background 
prtK:esses continue to provide services. A user is able \o quickly 
switch Ix’tween these two mtxJes. 

'The last mode is a dual Ixioi nuxle. No matter Utm hard 
Apple tries, some ap]>licaiioiis just aren't going to wi>rk in a 
conqiatabilily mode. Some developers have prognimined diTe<'tiy 
lo the hardware, and their applicalitins expect there lo he 
hardware, nor a nimpaiabiliiy layer. Desfiite there being veiy few' 
of lhe.se applications, stime users will want to eoniinue using 
them. T{> allow these u.sers to have acrexs lo Rliapstidy anti 
MacOS, Apple hits a dual Nxii niixle. At bool lime, users can 
chcKise to Ixxii into Riiapstxly and run the t^lue liox, or they can 
clKKise to IxHii straight into MacOS 8, With a relxxil, usc'rs w'ill 
be able to run their incomparable applications, then relxKH back 
to IdiapMxly as they need. 

WlUT IS THE YeIJOW BoX? 

The Yellow Box has two [>arts, the Java VM and 
OBBNSTEll The java VM has been talked about in just about 
every^ trade iiKiga?jne for the last year, but ORKNS'I EP, despite 
being around for almost a decatle, is still relaiively new lo 
most Macintosh programmers. 


Want to suggest an article for the 
magazine? Send your suggestion to 
<mailto:editorial@mactech.com> 


Apple's Java VM Ls still Ix^ing tiefined^ hut m> is llie Java 
language. Apple has fallen Ixhind on tlie Java curve, but is working 
lo catch up. A[)ple is promising jl)K LI for the VM, full 
implementation of AWT, and 100% pua* Java libraries. Apple is aLsi> 
providing the cnoss-platlbrm, web oriented java capabilities, and 
Apple is l(xiking to integrate Java into the system as tightly as any 
otlier language. Java under Rhapsody am nm Quicklmie3D, semd 
Apple evenLs, use native ctxle.,. whaRivtT. 

OPENSTEP is the tiiain part of the Yelltjw Box. OPENS'I EP 
is based on NEXTSITP. If has existed in one form or another 
for almo.st a decade, f:iiit in the last 3 years, NeXT has fleshed 
it out with Sun and HP lo provide a full-reatured framework for 
de V el o [ling a pplica t io ns. 

QPENSTEP, from NeXT, was a second gcneriiticm object 
orienteti framework. Originally, NeXT j>rovided developers with, 
most [X'tiple will agree, the most ptjwerful framework for 
developing applications ever seen. Study after study showed 
ht>w clevelopment under OPENSTF.l’ would go 3 to 10 times as 
fast as under either Maeinlosh or Windows. NeXT, however, felt 
that it wasn't gtxxl enough, and they sat tlown and redid it. 

They ttxik everything that tlevelopers liked, and expanded 
them. They then fixed jntxsi the [iroblems developers had 
Ixen comf>hiining alxjut for years. Iliey then addressed the 
issues developers were going lo have in the hiture, but hadn't 
gotten around to yet. Now, Apple <jwns it, and is adding more 
technology to make it even iK-tter. 

Even though this sounds like a lot of marketing speak, Apple 
was prepajcd to .shr^w off their power 'Ihey .started with a demo 
where a marketing pta'stm made a version of SimpleText without 
writing a single line of code. They then fiad engineers come up 
and talk alxjut bow to implement various technologies. If there 
was one unifying theme, it was siin[>lii ity anti rapid development. 

Is iiiE Yellow Bt>x jusrr OPENSTEP? 

Even without OPENSiTP's rich envinmment, Apple has led 
the market in certain areas. Apple is the leader in QuickTime, 
and iheir scripting environment is second to none. 
Eurthermore, Apple defined eaw-of-use, and while NEXTSTEP 
is the easiest to u.se i ivix, nothing is as plea.sant as the 
Macinif>sh user's experience. 

A|>[>le has already ported the Quicklime Media Uyer, 
ColorSyne, GX Typography, and Vfwin lo the Yellow Box. 
Apple is also rix'iiling more widgets, such as the TabView and 
OuilineView. The OutlineView is the Binder View, and by 
making this public, developers will be able lo make their 
applications kx)k and feel more like the Finder, and each other. 

Apple is also w'orking on porting AppleScript by 
Integra led it into the framewf>rks. As any application 
developer will tell you. implementiag a full-featured 
AppleScript environment can be as much work as all other 
features a>ml)inecl. While that's an exaggeration ft>r most 
applications, it’s still very difficuli, By purring AppleScript into 
the framework, the hope is to make su[)pt>rting AppleScript as 
easy as anylhing else under OPENSlld^ 
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WiiAT’s IN OPENSTEP 

is made up of :i number of different kits. I’he 
original kil — ttie AppKit — fiandles all IJl features such as 
windows, views, menus, and controls. The A]3f>Kii has l>c^cn 
expanded and revamped over the years to provide more features 
and to be easier to use. 

NeXT alscj created a MusicKit to lielp develofiers create 
music applications with full .suppciri for MIDI and score files. 
[JnfortunaLely, very few applications based on the MusicKit were 
ever createef and NeXT eventually unbundled the source and 
released it, with full sources, on the Internet. 

Uter, NeXT realized that connecting to ditahases was lioth 
ini[K>rtanl and hard, Every dataijase lias a different API, and eac'h 
version of each database is sliglitly different. Furtheniiore, every 
datal^iLse API is hard to use. NeXT's first attempt was the cfbKit. 
The dbKil wrai>fx.‘d an o[>ject oriented framework arouixl any 
database, A retrieval returned a list of objecLs containing the data 
requested. Complex searches and joins were, likewise, done 
through an object’oriented approach. 

Unfortunately, NEXTSTEl*, ai the time, was noi powerful 
enough, and clhKit had serious design flaws. NeXT resi>ondecl 
l>y dropping dl)Kif, creating a more powerful framework called 
the FoundationKlt, and re writing the dainbase kil as the 
Enterprise Objects Framework (EOF). Even ihougli EOF has a 
different API, and is more powerful, the basic concepts bdiind 
it are the same as in dbKiL. 

Tlte F(jundationKit dealt with two major difricicncies in the 
original NEXTSTEP, garbage collection and the ability to 
encapsulate arbitrary data in objecLs. 

Automatic garbage collection was needed lo manager ihe 
deaikx.'ation of objects reairned by functions. Each time an object 
was returned, there was always the question of wliich object is 
rcsjionsible for freeing it. If ihe nxxriver didn't free it when it was 
suppo.sed to, memory leaked. If the leceiver frccxl it wlieii it 
wasn't supposed to, the second free meiluxl would cause a crash. 
dbKil passed a large numlx^r of objects tlirough its layers, and at 
each layer, there was jxjtcnu^il for leaking. Automatic garbage 
collection handles this problem by letting (ji>jects Itold and release 
objetis, ihcn frtxring them at the next iteration of the event loop. 

Objects that encapsulate data are important as databases 
return num[)ers and strings. Dealing with the return values as 
either strings or data can lead to confusion. The same call can 
return a string one time, a number the next time, and a list of 
strings and numbers the third time. Worse, memory allocation 
for the storage has to be freed, and the arbitration of memory 
freeing is a nightmare. 

NeXT dealt witli this by creating a data object. Any niimix.T 
or siring can be placed inside an NSl>ata object. Automatic 
c{>nversk>ns between types alk>w programmers to abstract the 
return type and dcxil with i,lie data as nealed. Furihermore, the 
garbage collection handles memory alkxaion and freeing. 

Thf User Interface Iayer 

Apple has evaluated user experiences witli die Macintasli, 
and has found that diversity is gocxl. Some users want a “modem" 



The professional web page development tool 
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look with 3D grapliics and soft gmy-scalcs, otlicrs want a colori'ul 
experience, and some users with sight iin[Xtremenis need a black 
and white, high-contrast environment. Apple is giving us the 
A[>jX‘arance Manager so all u.scrs will lx saiistled. 

In theory, the Api)earance Manager alh>ws a user to 
specify how they want their applications to look, and all 
applications written correctly (and the vast majority are) will 
adopt the specified look. Currently, Apple supporLs only one 
appearance, and that one is the “modern” look, but Apple 
promises to help third party developers create a.s many 
appearances as they wanL 

No matter what the appearance, though, and no mater what 
.system is being run (Java, MacOS 8, Rhapsody, Blue Box, etc.), 
the User Interface Diyer will oil down to the appropriate hyvi 
underneath it. An OPENSTEP Window will know to c^ad die 
OPENSTEP layer and a java Window will call the java VM, even 
though, for the u,ser, the two windows look identical. 

For the developer, diis is great news. No longer will 
developers have to woriy atx)ut the nit-picky UI issues, such as 
using flai gray vs. dithered gray, and getting light .sources correct 
As long ^LS the guidelines arc followed, the .system will pul die 
correct appearance in the ap]^!icalion. 
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How Will Appucations Communicate? 

Applications can communicate througli Apple events and 
TCP/IR Applications can transfer data througfi die file system and 
copy and paste. Kltapsody applications can also talk to eacli 
other tliroLigh Distributed Objects and mach ports. Distributed 
Objects are a way of sharing objects beivvetm prtxiesses on the 
same machine or on different inaeliines. Maefi jxirts are tile low- 
level mechanism mach uses for communicating. 

Programming at the mach port level is not difficult, but it is 
not as straiglit-forward as most OPENSl’EP firogra mining* To 
make communkalion easier, OPENSTEP hides the mach 
messaging. One <if the ways of hiding the mach messaging is by 
putting a standard BSD UMix on top of iL In reality, die BSD layer 
is no easier to [irogram, hut it has the advantage of thousands of 
programs already suppoit it. 

The other, and better, methoci is the Distributed Objects 
(DO) mechanism. DO is used to transfer objects from one 
process to another. The receiving process cun be on the same 
machine as the sender, or anywhere on the same network. 
Once connected, it is irrelevant to ifie programmer where liie 
receiver or sender are. 

Unlike Java, where die entire objea, including byte ctxle, is 
sent, in DO only a proxy to the object is sent. Calls to iliat object 
dien result in a call acrexss a mach port* Calls to local objects and 
remote objects are identic'al, and from the application developers 


view, tlieir is no difference lietween a local object and a remote 
object. These mach messages are ciuite fast. 

Wmai File System Will We Use? 

'Ihe Macintosh uses HFS, and OPENSTHP uses a tJNix file 
system. Needless to say, there will have to l:)e a eonipatal;?ility 
layer between them. Apple has developed a multi-layer scheme 
to allow access to any Ole system from any layer. 

Apple has three goals with their file system: eompaLal>ility, 
performance, and expandibility. Compatability is more than just 
supporting existing Macintosh applications running with an HFS 
volume. Compatability issues now invt)lve juaking old Macinltxsh 
a])plications work with new file systems as well as making new 
applications work with the old HFS volumes. 

Performance Issues are always important, and they always 
will lx,\ but it’s gcxxl to see Apj^le R'cognixing the issue and 
making it a high priority. 

Expandibility is important for the future. In the past, the 
MacinLtJsli lias suffered from lack of expandability in the file 
system. Already, developers have had to deal with HFS versus 
MFS, using File Specs versus using rhe old style file operators, 
adding hart! tlrives, AppleSliare, and so on. Each time, there has 
been a new^ API progminmers have had to learn. In the new 
system, developers will write their code once, and no matter 
what changes ai a low'er layer, liieir code will still work. 

To achieve these goals, Ap[>le has gone with a multi-layer 
file system. At the bottom is the native file system. 'The new file 
sy.stem supports HFS, NFS, HFS (Universal File System), HFS+, 
and allows for new file systems created later. To accomplish tliis, 
all the native file systems plug into the Viitual File System (vfs). 

The vfs layer knows how to convert file information for the 
different volume formats and the different API's* The vfs layer I 
works with a .stack of modules. Each module is called in turn, 
and developers that used to patch the file system only need to 
add a module to rhe stack. 

AIkwc I lie vfs is cither tfie Posix+ layer, or an HFS/HFS+ 
layer* For Blue l>ox applkaticms, the IIES/I1I'S+ layer is the top 
level of the file system, and all Blue Box a]')pIications will access 
this layer. Even though ii is an HRS interface, oilier Ole sysLoms 
ean sit under the vfs and Ix-^ accessed. 

Rhapsexiy applications, have a variety of interfaces for 
accessing the Posix+ layer. For support of iitsax applications, tfiere 
is the P()six layer. OPENSTEl^ apfil [cations, liowever, have 
abstracted the concept of reading hies into tfie framework, in a 
nut-shelh tell an object to save itself, and it docs. Tell the oirjeci 
to restore fr()ni a file and the object unarcluvcs ilscif, taking into 
consideration version numbers for individual objects. 

One concern Macintosh developers have is their hie system 
metadata, 'fhe metafkiUi, on the Macintosh, currently consisLs of 
Finder info, bui tliere are many plans to ext>and metadata in the 
future. Apple recognizes this, and is looking to provide a flexible 
metadata scheme that is compatible with existing API calls* So 
far, Apple expects to support metadata ft^r all file system fomtaLs. 

Furtliermore, Apple rec^ognisies the need to get access to the 
File System at all levels and Apple plaas to release Al^Ts for 
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accessing all levels of the File System. In general, tt will always be 
best to access the File System at the highest level p<issitile, liui ff>r 
some developers, thene will always lx: a need to go t)iie level lower. 

How ARE Files Accessed 

Under the old Macintosh, files were Sfjccified by a directory 
ID, voluine ID, and a File name. Case sensitivity never mattered. 
Under the new system, files are accessed by path names, and 
there is an optional case sensitivity. In general, Apple recognizes 
tliat using pathnames can lead to problems, such as broken paths 
caused by folders being renamed, but to support all existing 
standards, pathnames will have to exist. 

Tlie optional case seasitiviiy is an interesting idea. Two files 
with liie same name but different cases can exist under most file 
systems. Under IIF’S, where the case is irrelevant, this is not 
possible, but under NFS f>r IIFS, it \s Ixxli likely and common. 
Under RliapstxJy, wlien a file is specified, first a file of the exact 
same case is looked for, if it is found, then that file is returned. 
If it is not found, then the vfs will l<x)k for any other file witli the 
same name and patli, \m\ different cases. 

Rhapsody, at the high level, is also providing some 
abstractions for file systems. As airt'aciy mentional, developers can 
read and wrire objats as files. In addition, dieie Ls an NSFilcliandlc 
oi^ject for handling file desai[)tors. Finally, there is a new file 
management abstraaum based on URUs. Apple Is excited alxnii 
using URL style files, hut they did ncX have a lot to talk alxwjt it 

Reading an object from a file is pretty simple. Here is an 
example: 

contents ^ 

SSString.jstringWitljContentnOfFllef#"/Library/README“) i 

Ihis is the new syntax to Objective-C, and currently no 
compiler suppoUs tliis syntax, but .stx>n they will. The W say;s 
to create an NSString object containing the string following it. 


Garbage Collection will clean it up later. NSString ts a clasvs, the 
*.* is die new way to c^all melhtxis, and stringWithContentsOfFile is 
a static method. Basically, diis one line of code will find, open, 
load, and t:k)se the file. As expected, diere is a command for 
saving an NSString to a file. Many OPENSTEP objects have 
methods to facilitate file system accesvses. 

Finally, tecause Apple wants to have full and sln)ng Java 
.support, they are implementing a Java like meclianisni for doing 
asynclironous file operations. As this was still in prelimary stages, 
Apple didn't have much to show. 

How DO tue Blue Box and Rhapsody Share Hard Drives? 

Apple is going to provide three mechanisms for dealing with 
hard drives, and they will vary as far as cc^mpaialhlity versus 
convenience, Tlkcrc will be Blue Box only drives, Rhapsixly files 
that kxik like Blue Box drives, and drives shared between 
Rhapstxly and the Blue Box. 

Blue Box only drives will lx: compaiablc with almost all 
existing software. Tliere may still be a few appficatiems that 
break, but Apple is going for maximum comparability. 
Unfortunately, any ckita .saved by a Blue Box application on a 
Blue Box only drive will not be accessable from a Rhapsexly 
ap[>iication. As far as user experience goes, this motie is only for 
the last ditch, have to get this one piet'e of software I own 
ninning, type of u.scrs. 

Drives shared between Rhapsody and the Blue Box are 
most convenient, hut patches to the file system will break. 
A lor of software out ilicrc patches the file system. Disk 
doul>lcrs, some compression software packages, MPW, all 
patch the file system, and none of these will work. 
However, most proditctivity software packages will work 
just fine, and being able to save a file from the Blue Box and 
open it in another application under Rhapsody will offer 
users the best environment. 
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The final [node, die Rliapsody fik- LliaL look.s like a Blue 
Box volume offers some advantages over the other modes. The 
hard drive shows up under Rhapsody, hut a file can be turned 
inuj a iilue Box volume. The Blue Box will treat the file as a 
volume, and write to it like a volume, Rhapstxly applications 
c^r\ access it at lht^ raw volume kwel, but wonT have easy 
access to die files in it. Tliis would be tire route fc^r a user that 
needs a Blue Box only volume for an application, but does not 
want to give up an entire hard drive. 

One last thing to talk about is HFS-f-. HFS, the file .system 
Apple has used for many yeai-s. has several problems. The 
biggest is the large alkKatic^n bl(x!k size. With today's one and 
two gigabyte drives, users are finding trivial files take up 44k. 
Furthermore, HFS files are limited in size. Apple has rewritten 
1-1FS to provide small alkKatinn blocks, large files, and direct 
unk:t>de support, and they have added extensions for Rhapsody, 
such as |x;rniis.sions, hard links, and better dale supfKirt. Al! this, 
and [1F'S+ is still computable with I IPS. 

RiiAPSOUY LISES Virtual Memory 

ldia|Xi(xly apj^ilications, Ixing based on mach, will .see and use 
vimual memory ai all timers. Blue Box ap|:jliaitioas, on tlie c^her hand, 
will never stx^ (he VM, even though the Blue lk>x will use it. Gestalt 
will even go so far as to say VM Ls not running. Tlienc will be a ntw 
Ai^l for requeuing held menuiry at a later time, but existing 
appikatkjas will hive to hc^ updated to use this. Meanwhile, this will 
cause some problems for c.-ertain applications. Applet's .s(>Iution is to 
provide an o[ition for starting the Blue l?ox to am using only f>l!ysical 
memory and newer swap any of its memory. 

Under normal use, though, the memory map will have a 1 
gigabyte virtual space. Running a[)f)licatrons will think there is a 
full gigabyte of RAM in tlie machine. Bach a [implication can set iLs 
partition to 100 megabytes and use all the memoiy it needs, oi' 
the merm>ry [>aitrtion can be left alone and hundreds of 
ai>plications can be run. A[)plicalJons will allocate their memory 
from the core OS VM, not from temp memory. 


Want to share a tip with the 
conununity and get paid for it? 
Send it in to 

<mailto:tip$@niactech.com> 


Furthermore, guard pages will be aclded around application 
stacks and heajxs. Nt> more walking off the sUtek and trashing 
memory. Unfortunately, this will break a few apps that try to 
walk the heaps^ but for the extra .stability, it is well worth it. Once 
again, if users have an incompatable appikalion they need lo 
run, they can aim off the new memory map. 

How wiix Devicf^s Change? 

In a shared Blue Box/Rliapsody world, tliere are going to be 
device conflicts. Because Apple is moving to Rliapsody, and 
lx.x‘ause the Rlia[>sody’s driver iikkIcI is cleaner, Afipie is going 
to favor Riiapsody drivers over Blue Box drivers. Where 
Idiapsody is set to ignore a particuiar device, then the Blue Box 
can access ii dirccily, otherwise, the Blue Box will use Rhapstxly 
accessing tlie devices. 

In the Blue Box, there are no native device drivers, no ndrv% 
no name regi.stry, n{> SCSI atxx^ss to devices Rhaps<xly is 
accessing, no VIA access, no SCO access, no ADB suppijrt for 
devices in u.se by Rhapsody, and so on. In other words, if the 
(.lore OS t an hantlle it, the Blue liox ean't touch it. 

There will l>e some suppon kjr native drivers in the core OS, 
and DRVR’s that do not touch the hardware will continue to be 
supported. Furthermore, serial ports accessed through 
OpenTransport or the serial driver will continue to work. 

What abolb' TCP? 

Apple knows how important the Iniernet is, and how 
irnponani both existing applications and standard unix 
appliaitions are. tJufortimately, A[>ple and UNrx have folkjwed 
very different miKlels for communicating over TCP. To further 
complieaie tilings, ilic* Blue Box does not really know about 
Rhapsody, so anything Rhapsody does to the TCl^ stack has lo 
have minimal impact on the Blue Box, In a nutshell, there has 
lo be two 'rCI^ stacks running. 

Wilhin the Blue Box, OptrnTranspori will continue to he 
available, including the OpenTrans[>rot cktssic Ap[>icTalk 
compatibility service.s, however, OpenTransjiort will require new 
low-level driver mcxlules. 

Again, Apple lias come up with a llexihlc solution It? a hard 
problem. If.sers can decide to either share an IP address Ix^tween 
Rhapsody and the Blue Box, or give the two different IP 
addresses. In reality, Rhapsody .supports multiple IP adilresses, 
so this is not a difricult choice. 

4lie single IP adtiress is best for machines that connect over 
PPP and are assigned a single atldress. Sharing the TP address will 
have limitations as a user can run into fXJrt conflicLs, liut overall, 
that is an easy problem to get around. 

Hither way, packets are multiplexed at the driver levid anci 
sent up different stacks de}:x:nding on the port in use. Apple will 
be working veiy diligently on [x^rToniiance is,syes. 

Uk:aijzation 

OPENSTEP provides a powerful, and easy to use 
localization system. Before talking alxiut how to localize under 
OPHMSTEP, a refresher in Macintosh localization is in order. If 
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iherc i,s fi roiuint; that needs to put a string in a dialog, getting 
il»e string would he along the Imes of: 


Slr 255 nSlrtng; 

G^iindStrltigCaStrin]^. kSt r 1 n£R(>f;our<^(^1D. kThlAHessa^elD}; 
if (aStringlD] = 0 } 

EiockHoVt^t "\pThls ny roesaagD”, aSirtrig^ 19 ): 


1 


After tknng this a few hundred times, developers start 
writing special routines just to make the source cxkIc rcackihle. 
Of course, the programmer better remenilx^r to ackl every siring 
to a resoura* file. 

Under OPERSThP, NeXT simplified this into one call: 
NXLocalizedStringfconstchar *key, const char‘value, comment), Tlie 
c'all to NXLocatizedStrirrg kK>ks for an entry for key and uses the 
value retnrnetl. If die key i.s not kKiilizcd, tlicn NXLocalizedString 
will return the value. The comment field Ls used fur 
automatiaiiiy genenning localizitilon files, 

OPi{N,STlil* lias a command line |)rognim called genstrings 
til at runs on s^x^cified source files to create a localization file. 
Tlte file will have the format "key”-“value"; /*oommentV. Tlie 
comment ht.dps lot'alization experts generate correct keys. 
Duplicate key/valuc [Klirs are merged. Most OFENvSTEP 
developers use the same value for both key and value in their 
native language. *rhis makes the key easier to generate. No 
matter how many NXLocali 2 edSlring( "Tes", "Yes", ‘This is a Yes"); 
there are, there will Ix^ only one ‘‘Yes”=^*'Yes"; line in the 
IcK’alizaticm file, 'fhen, when ported to another language, iIktc 
will Ix" only one entry lo naxlify. 

The localization file is actually a dump of an 
NSStringTable object. Once loaded, the loc'alization file c:an be 
treated like any odier NSStringTable. In addition, NSStringTable 
objecLs can be aeated on the fly and used by routines similar 
to NXLocalizedString, 

The localiza!ion file works in concert with the nib files. 
Nib files are used by NeXT's Interface builder application to 
store User Interfaces. Like the strings embedded in die cckIc, 
the User Interface will netid lo be modified lor each 
language, bach language's nib files with that languages 
localization file is placed in a subdirectory called 
<language>Jproj, Hach Iproj is placed inside of the application 
wrapper An afiplicatujn wrapper is actually a folder, hut 
appears as a single file to users. Double clicking an 
application wrapper will launch the application, not open die 
folder. A,s each language has a different name, many Iprojs 
can be placed in the application wrapper. 

On a Macinuxsh, each binary can liave only one restxjtce fork, 
and rhu.s, eac:li binary can only lx: kxalized for one language. 
Under OPIiNSTbP, multiple Iprojs allow a single liinary to supprm 
multiple languages, skiving a great deal of spitce for places ilmt 
ntxxl multipk^ language supjxM of dieir applications. 

Furtheniiorc, since each application can have multiple 
languages, ihc users can set the preference for wfiit'h order to 
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look for languages. If a user has hh preferences set to French, 
German, Engli.sh, Japanese, the system will first look for a 
French.lpmj, dien a Germanjproj, and so on until it finds a 
language the application .supports. 

Ben Wati; Tiu^'s More*,, 

Unfortunately, despite all the additional informal ton Afiplc 
had to offer, there was no where near enough time for me to see 
ii all, nor was there time for me to get it ready by the print 
deadline. As it is, 1 have to thank ihe editors for already 
stretching their deadlines, 

Some ihings to tantalize you with, though, arc a Text 
system ready made for Unicode, multiple views, custom inpui 
for multi-byte languages, anti glyph sufipori; fprinting support 
lhal will make you drtx>l; NSString objects for quick and 
powerful manipulations of strings; Web(;)b}ecT,s; full java 
support; tJte most powerfirl imaging sysiein this side of a liigh 
end printer; and the itsi goes on. 

Apple has promised a kx in the past that they have l>ecn 
unable to deliver. NeX'L has been unable to sell anything llicy've 
delivered in liic past. Put tliein logctlicr, and if their strengths 
compliment each other, they should Ix' on to something. This 
could Ix' the match that turns Apple around. After a week of 
bsiening to Apple, 1 IxJicvc again. B 
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Stratego® 

In recognhion of Ditap Blue's chess victory over Garry 
Kaspiirov (and I would liavo said "In cdebraUon of except 
that 1 liiwe mixed feelings about the outa)me), we return to our 
series of board game Tournament Challenges. I'his month, you 
will be writing a program U> play the game Stratego. StraTego is 
a board game played on a reaangular 10x10 grid. Eadi player 
Ix^^gins the game with 40 pieces^ one c>f which is a Flag. The 
object of the game is to find and capture the opponent's Bag. 

The pieces provided to each player at the beginning of tlie 
game, in order of descending rank, are as follows (quantity in 
parentheses): Marshall (1), General (1), Colonels (2), Majors (3), 
Captains (4), Lieutenants (^), Seargenl (4), Miners (5X Scouts (B), 
and Spy Cl). In addition, each ]:>layer is given Bombs (6) and a 
Flag (1). At the stJiTt of play, each player places his pieces in die 
four rows nearest his side of ifie board sik'h that their rank, 
which is visililc from one side of a piece but not from the odier, 
is hidden from the opponent. Players alternate making moves, 
with Red moving first, then Blue. Each turn ccmsi.sis of either 
moving a piece into an t>[)en st|uare, or striking an opponent's 
piece in an adjacent square. Excejit for the Scout, Flag, and 
BomI) pre<::e.s, each piece can move one scjuare forward, 
Ixickward, or sideways (fjut ntjl tliagonally) on a given turn. 
Flags and Bombs cannot move at all. ScouLs can move any 
number of open squares forward, backward, or sideways {hut 
again, not diagonally). 

If a piece i.s moved into an adjacent st|uare occupied by an 
opponent, the move is referred to as a “strike”, which results in 
the lower ranking piece being removed from the board, and the 
higher raiTking piece moving into the sc|uare formerly oct:upied 
by the losing piece. When both pieces involved in a strike are of 


equal rank, Ixuli idcces are removed. A Marshall defeats a 
General, a Genend defeats a Colonel, etc. The Spy is the lowest 
ranking piece, and is defeated by any other piece, except that a 
Spy defeats a Marshall when the Spy inhiaies the strike. Any 
piece except a Miner striking a Bomb is removed (and die Boml) 
remains in its original position). When a Miner strikes a Bomb, 
the Bomb is removed and the Miner moves into the square 
formerly occupied by the Btimb. The Flag and the Bomb cannot 
move and cannot initiate a strike. The game ends %vhen a player 
strikes the opponent's Flag. 

Your code will lx: com]x:Ling in a niund-robin tournament 
against other Challenge entries. The prototype for the code you 
should write is: 

^define kBoardSixe 10 

typedef etium t kUnknowii=‘0. 

kMarshall=l,kGenf!ra]. kColotifil .kMaJor.kCapt n in. 
kLleutf^narit,k£i^rg<^arit,kMi rter,kScmil ,kSpy 
[ PieceRaink: 

typ^^def enutn IkRed=l .kDlue=2 t PlayerColor: 

typedef struct PieceType } 

PieceRenk thePleceHank: f rank of a piece 7 
Pi ayerCa lo r iheP i nceCt! lor; /* color of a pietx- •/ 

I PiecoType: 

typed&f FieceType HoardIkBoardSiaeJ LkBoardSlzeJ : 

/* Used to provide icsi c(Kle with board confi^piration. Red Marts 
1(1 rows 0..5, Blue .stiin.s in rows 6. .9 V 

r Squares |4lI2i,Hl[M, [4|t6|, fdlE?! and BII21,IS1BMS]|61JS1[7I are water 
and canmn be occupied 7 

typedef struct PiocePoalLluii t 
long row: /*a.9 7 
long col: /*<U7 
} PieeePosition: 


THE RULES 


Here's how if works: each month wc present a new progjumming 
challenge. First, write some code that solves the challenge. Second, optimize 
your code (a lot). Then, submit your solntion to JVIacTecii Magazine. We 
choose a winner based on code correctness, speed, size, and elegance (in 
that order of imfiorLince) as well as tlie submj.'ision date. In the event of 
mulUple equally desirable solutions, well choose one winner (with 
honorat>le mention, but no prize given to the runner up). The prize for each 
month's fK"Xt sfdution is a $100 credit for Developer Depot™, 

Unless slated otherwise in die problem statement, tile Following rules apply: 
All soluticHis must lie in ANSI coinixililile C or C++, or in P:iscal. We diij(]ualify 
eniiies witli any asseiiildy in lliern (excqil for challenges spedhcally setting 
otJierwise). You may call any Macintosh Toolbox routine (c.g., it doesn't matter if 
you use NewPtr iastc^ad of mnlloi’:). Wc compile all emthes into native PowerPC. 
ccxJe with compiler optitms ,set to ena!>k: alt available .speed (iptimization-s, Tlie 
dcrvelopment envininment to lie used for selecting the winner will Ix^ stated iti the 
problem, limit your code to 60 clLaraclers per line or compress and binliex llie 


solution; this heljxj wiiJi e-mai] gateways and page layout. 

We publish Uie solution and winners for each montli's Prograimiter's 
Challenge three months later. All h-uljmi.sstons inu.'ii he received by tlie Ist day 
of die m<5nth printed on die front cover fif Uris issue 

You can get a head start on the Challenge by reading the Programmer’s 
Challenge mailing list. It will be posted to the li.st on or before the 12th of the 
preceding montli. To join, send an email to lisi.serv@ list mail xplain.coni witli 
the subjea “subaribe challenge-A". 

Mark stduiions '*AUn; Programmer's Challenge Salution" and send it by 
e-mail to one of the Prt>grammer’s Challenge addrc,s.se.s in the “How to 
Communicate With tis" section on page 2 of thi.s Lssue, Include the solution, 
alJ iielaieci hies, and your contact inhx 

MiicTech Magazine rcsserves the right to publish any s<.jluikjn entered in 
the Programmer's Cliallenge. Authors grant Mac lech Magazine the exclusive 
right to jmblisli entries widioul limitation up<m .submission of each entry. 
Authors retain t:opyright.s to the tXKle. 
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typedef struct HoveResult i 

P iec eTyp e a 11 ac ke r; /* after a strike, a'tiims rank of anaeVer 7 

P L ec eTyp e d ef end e r: /* after a st rike, reiiirns rank of tkfcntlcf */ 

Boo1 ean attacker Removed; /* Iroe afier a strike a piece tif equal 

or greater rank, or against a bonib when tite attacker is not a Miner 7 
Uool ean defendcrRcmovcd; T True after a strike by a piece of equal or greater 
rank, iiT against a Ixmth when the attacker is a Miner, or against a Marshall by a Spy 7 
Boolean victory; /* true after a strike against the Flag 7 

Boolean iegalHove: /* thk! imless you 

»move into an oeeupkd square, or 

' move or strike in a ilireetioti other titan rurwanJ, backward, or sideways, or 
' move mote than ttne square (except Scouts), or 

- move a Ikmib or a Flag, 

- uutve into Water, or 

strike a sqiiaa- not tx^nipkal by an oppitnent, or 
’ make :uiy tutier ilkijiii mtivc V 

I MoveResult: 

VO Id PoBirIonPlecfiB( 

void ' p r i V Sr o r a £ e, /M MU of pceiniliali/ed storage for your ust- V 

PlayerColor pi ayorCol or . /* ytm play red or blue, witli red playing first 7 
Boa td * thi?flOiitd /* pmvhle the initial position ttf voiir pieces ’/ 

); 

typedef void (‘ReportYourMove)[ 

/* i’allljack ttj inform test code of nnwe and get rt^nits 7 
P i fi c e Po R i 11 0 n ‘ mov eF r om * /* piece y <ju are moving or using to strike V 

Pi cc cP Ds i I I o n ' tnov eTo. f destination squate or square beuig striklc 7 

Boulciii! strike, /* false indicaies a move, true indicates a strike V 

HuveResul I * resu Us /* fctums identity of struck piece and other into */ 

): 

typedef void ('GetOpponentMove)( 

/• Callback to get results of tqqxMiems last nkive 7 
PI nrnPorf 111 on * moveFram. /* piece oppoitent itKwed or used lo strike ‘/ 

PI cccPoi; 111 on * moveTo, r destination square tir square struck ‘/ 

Eooleuii * t; L r' I kc, /* ^be indicates a nuive, Lnie IndicaLes a strike 7 

MoveResult * resiul Lt* /* retiirns klentity of stntek piece and tJther inkt 7 

): 

Boolean /’1'RtJB eJaiots victory or illegal op|K>nenl move 7 HakeAMovt? { 
void * p r 1V K1 0 ra g ft, I MB of storage from PitsiUon Pieces 7 

P ] a y c r Go 1 fj r p 1 a yn r Co 1 o r, /* y< )u play red or Hue, with rcd p laying first 7 

Gc tOpponent Hove ^ GfttMovft, /* callback used to make a move V 
RftporL Your Move ' Report Move T callback used m find about opponent last 


Your Position Pieces n>utinc will l>e called at the iK'ginning 
of each game so that you provide the initial position of your 
pieces. If your playerColor is kRed, you sfiould tx:cypy rows 0..3 
of tile iK)ard, ollicrwise you .should occupy rows 6..9. You 
should set theBoafd[row][col].thePiec6Color to your playerColor 
and theBoard[row][col].thePieceRank to the PieceRank you are 
placing on eacli square. As indicated in the lypedef for theBoard, 
eight squares in the niiddte rows of the hoard are water and 
caimor be occupied by piett^s of either side. 

Note that theBoard is used only to pass your initial |X)sition to the 
test ctxie - you may choose your own data stnictufe to keep track of 
your pieces and the knowletlge gained about your t>pponcnL's pieces 
7LS ihe game pnigjesses. PdsilionPteces will lie provided with IMti of 
prealkxated storage pointed to by piivStorage, 1his sttirage will htf 
initialized to Kero Ix^fore Position Pieces is called and will peiTiisi 
beiween moves. You should not allocate any additional dynamic 
storage beyond that provided by prtvStorage. Small amtHinis of .static 
storage are permiltcil. 

The ntirmal move set[uence coasisLs of finding out via the 
GetMove callback where your opponent moved on the previous 
turn, determining your next move, and finding f>ut the resulus t>f 
that move via llie ReporlMove callback. Your MakeAMove code 
should include something like this; 


If (IflrstMovft |[ {playerColor—kBiue)) I 

C •CfttHovft) {4opponentl(oveFroin, &opponentHoveTo* 

topponentStrike.iopponentResult): 

} 

r ncsjxTiKl to opponent move, ami ealciilatc yif>iir move 7 
t • ReportHove) t SnyMoveFrom * iisyMov^To. wyS I r tkc. iiiuyResul 11 1 
t pfixcss ttriiiJlLs move 7 

You provide ReportMove wtili the location from wiiich and 
to wliicli you are moving {moveFrom anti moveTo, respectively), 
and .set strikG to TRUE if your move strikes one of your 
opponent’s piec es. The ca III racks will iHipuiutc a MoveResuTt data 
structure lo refiect the results of your opponent’s last move or 
your current move. Flags are set to indicate whether the attacker 
nr defender (or I'Mith) are removed as the result of an attack, and 
PteceType fields are populated when an attack reveals 
infojinaiion about a piece. 'I'hc key ro winning a game is 
properly interpreting the moveinent and laclics of your 
opponent, deciding when and where to strike, and using the 
infoniiatioji gained in tho.se strikes to best advantage, GetMove 
should return TRUE when you claim victory or when the callback 
imlk ates that an illegal move lias Ixai made. 

The Challenge will b^ scored by a tournament where each 
entry plays against each other entry an even niimlxr of limes, 
half playing first and half playing second. Another fair 
lournament ,sc!iedulc might lx used if a large numlxr of entries 
ate recrived. [*or each game, the winner will earn gtime jx>inLs 
lor the victory, minus an amouni liased on the execution time 
used to compute the moves, as follows; 

pciinis in - ftXftftLiTion time in RftcoTids 

The loser will earn xero [KhnLs and will not lx* penalized for 
ihe execution time expended in defeat. No pcjints will lx* 
awarded for a tie. I'hc player with tht* most r(aal ptiinLs for all 
gamt*s in the tournameni will lx tiie winner. This will lx* a native 
PowerPC Challenge, using the latest CodeWarrior environment. 
.Stilutioas may be coded in C, C++, or Pas<‘al. 

Stratego is ® I960 in die IPS. Patent Offiee and is © 1961 by 
the Miiton Bradley Company, 

Timiai Mopmis Ago Winner 
The Equation Evaluator Challenge posed in May required 
contestants to reproduce part of the functionality of Apple’s 
Craphing Calculator. The problem was lo parse an input 
ajuation and tlien evaluate it for combinations of up to three 
variables. Selecting a winner proved to lx* difficult, as none of 
the six entries I received prtived Lo be completely eorrecU One 
of ihe fastest of the nearly correci entries needed only a trivial 
code change to be completely correa, met all of the accuraty 
requirements, was among the fastest t>f ilie nearly correct 
entries, and was die smallest of the Cop entries. Congratulations 
to Mark Day (Saratoga, CA) lor submitting the winning entry, 
based on correctness, speed, and size. 

Mark patstfs the input cqtialion into a binary tree of 
TokenNode data structures, generates a sequence of PowerPC 
instructions in the CodeGen routine, and ihcn executes those 
in.struclit)ns to evaluate the input equation over the required set 
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of values. As permitted by the problem statement, the 
CallGeneratedCode romine makes use of a small amount of 
assembly language to execute the generated code. The key to 
code generation is the subroutine CodeGenTree, which 
recursively produces the code corresponding to a given 
I’okenNode, beginning willi the rkjL ntxle. One thing to take 
note of as you look at the winning solution is the technique used 
to call library functions: a set of enums (e.g., kFuncSin) 
corrcssponds to an entry in the global function table gFunctions, 
which is accessed via a dedicated register (regFunctionBase) by 
the CallFunction code. Also note the use of MakeDataExecutable 
j>rk)r to execution of the generated crxle. 

Tuiiough O'Connor also generates Powerl^C instructions to 
solve the problem, but he demonstrates how to call the 
generated c:cxle without direct use of assembly language: 

coJcBlDck - N£?wFtr(kCudeBiockSlze) ; 

// p^Start round up to iK lx>undarv 

paj^eStart = {Ptr) C C(UInt32)codeBlock t OxFFF) & «0xFFF) ; 

^PC - (UInt32 *)pageStart: 

prologStart = gPCi 

// (SNIP] - generalt* prolog smiling ill pstgt Smn, iinil cikIc starring at kjocSiail 

MuktfDti LaExecutabie (pageStart. 

(UInt32)gFC - [Urnt3Z)pageStar1:): 

typedaf struct 1 
void *pror.: 
void "rtoc; 

I TVfictor: 

lyped^jf void (‘G^nFuneJ(const Values ‘xP, const Values *yP, 
const NValues *nP* Results *vP, 
const ConstFuiicTable *conEtTabIe] : 

TVector ourVec = ffuncStart* Oh 

GpnFuJic ourFunc = (GyuFunc)ifOurVec; 

(ourFunc)(xF* yP* nP* w* &gConstFuncTable): 

'I'hrce of the remaining solutions (Willekc Kieken, Rrnst 
Munler, and John Nevard) ttxik an a[^[:utjacli that tlid not invt>lvc 
generating l^owerFC code. After parsing the input equation, these 
solutions evaluated the etjuaiion direcily using a virtual machine 
of one sort (ir another While this ajjproach was generally slower, 
one of the solutioas was ctrmpetitive and could have won had it 
not suffered from an accuracy fjroblcm in a tost cast; Involving a 
truncated Taylor series ex[>ansion of a trig I'uncLion. 

I evaluated the entries using 17 test cases, designed to 
execute in comparable amounis of tiimb anti summed the 
execution times to [>roduee die Irnal score. Tlie test cases 
included combinations of ariilirnelic operations, trigonometric 
furiciions, iiy|x:rbolk: fimtiions, .square ifK)LSj lt>garithms, and 
exponentiation. One test case included the tmneated Taylor 
series mentioned above. Several test ca>ses used [xiiar c(H>rdinates 
as the etjualion inpiiL Two of the entrie.s, including the winner, 
had problems with polar eixjrdinates: the winner olculaled the 
angle as atan2(x,y) instead of atan2{y,x), while another entry used 
the atan function instead t>f the atan2 function, 'Hie former was 
easily corrected, while the latter was not. 'fhree other entries did 
not meet the relative accuracy requirenietit sjx^cified in the 
problem, and trne incorrectly processed some of the test cases. 
Only the last entry was disqualified. 


The table below lisLs for each entry the total execution 
tine for all test cases, the .severity of the errors in the solution, 
code and data sb.es, and the programming language used. 
The number in pareruheses after the entrant's name is the 
total number of Challenge points earned in all Challenges to 
date prior to this one. 


IName 

Time 

Errors 

Code 

Data 

Language 

Mark Day 

289 

aian2(xy) 

7328 

1364 

C/Asm 

Wilk:ke kieken 

284 

arciiraty 

16796 

1779 

C++ 

Tiirloiigh O’Connor (7) 

284 

atan 

15172 

192H3 

C++ 

Encsl Munier (242) 

341 

accuracy 

8904 

794 

C++ 

John Nevard (17) 

418 

acci iraty 

4520 

2126 

C++ 

M. N. 

259 

correctness 

16356 

1799 

C++ 


Here is Mark's winning solution (wiih some formatting 
changes and deletions la reduce length — see the ftp site for the 
full code listing): 


Evaluate-C 
© 1997 Mark Day 

// Contains nniirnc.^ f<> pnrsc ah itiiuitmn luid drive tlie 
// vv^iliiaiiun iif i\ui cqimlioii over :i sei of in pul valuesi. 

^include <ctype.h> 

#lnclude <strlng,h> 

//inctiidfi <E(iaTh.b^ 

iiindnf HllGK_VAL //fp.h n^defities ibis 

^Inelude <fp.h> 
i^includt* <M&«ory.h> 

^include <03Utii.s.b> 

“Evaluate. h*' 

ii long gV.ariablpFtags; 

ELruct TokeoLookup I 
int token; 

int which: 

char ‘string: 

I: 

typed ef fStruct TokenLookup TokenLookup; 

TokcuLoukup ^TukoiiLookup fl - I 
lokLcfiParen. kieftParetiH 


tokRightParen, 

kRightParen. 

tokAddOpH 

kAdd, 

tokAddOp, 

kSubtract. , 

tokMulOp, 

kMultiply, 

tokMulOp. 

kDivlde, , 

rokPowr^rOp. 

kExponent. 

iokRoot Op, 

k FiJ ne Squa re Roo i , " \ \ . 

tokFacLorlal* 

kFuncFactoriai. “!"* 

tokFuuction, 

kFuitcLogtJ, “In", 

tokFunction. 

kFuncLogTen. 


// IJyperiioHe fnneiioiis need come Tirsi ur eLse ihey 
U would parw; as ibe normsil plus an extra 


// "h^eharaetcr (whieh m:ikes lor 2 syntax error) 


tokFuuctlon. 

kFnnrSinh < 

".si nh" * 

1 ok Fund Ion. 

kFuneCosh. 

"cosh"* 

lokl'urR l Ion. 

kl'‘nncTurih, 

"t nnh"* 

tokFunetloii. 

kFuncSech. 

"sech". 

tokFunction* 

kFuncCsch, 


tokFunction, 

kFuneCoth. 

"coth”* 

tokFutiction, 

kFttnr.Sin, 

"sin”, 

TokFunerIon* 

kFimrCoG* 

"cog", 

lokFiind ion. 

kFnncTan, 

"lari". 

LokFuncilori, 

kFiiticSee * 

"sue”. 

lokFunetlon* 

kFuricCsc * 

“CSC". 

tokFutiction, 

kFuneCot * 

"cot”, 
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tokFunctlon. 

kFuncArcSin. 

tokFunction. 

kFuncArcCoSp 

tokFunctlon. 

kFuncArcTan. 

lokFunerion. 

kFuncArcSec. 

tokFunctlon. 

kFiincArcCsc* 

tokFunctlon. 

kFuneAreCot. 

tokFunctlon. 

kFuncAbs, 

tokVuriabio. 

kPl. 


LokVariahla. 

kR, “r". 

LokVariablc, 

kX, -x". 

tokVatiublo. 

k?., 

"z". 

tokABsign. 

kKquulu. 


"askin'', 

“atan"* 
"asec*** 
"acBc” * 
“acQt". 

“abs", 


tokVflirlable, ltE» 
tokVariable* kTheta, 
tokVarieble, kY, “y** 

takVariable, kiJ, “ir> 


roklnvalid, klnvalidTokenn 


// 

// 1’ht‘sc art sinjilt precision versions of Hmctions, nor 


// found in either nuidi.h or rp.li 
// 

statie Iloal Factorifll (float x] I return 

static float Secant(float x) \ return 

static float CcS«?etirn (floai js) t return 

Static float CoTangeot (float >t) [ return 

static float ArcSecant(flaat x) I return 

static float ArcGoSecartt(float x) I relurn 

static float ArcCoTangent(fioat x) ( return 

static float BypSecant(float x) ( return 

static flout HypCoSeranr(float x) ( return 

static flout llypCoTiingcoi (float x) t return 


gammuCx+l.0}; ] 

K O / coaf (x): 1 
1.0 / fiinf(x): 1 
1.0 / tanftxj; ] 
acosfCl*0/x); 1 
as i nf (K O/x); 1 
atanf(K O/x)» I 
1.0 / cosbr(x]: I 
1.0 / sinhf(x); 1 
1.0 / tanhf(x): J 


typedef float (M''loatL*uiic} (float): FlnatFunc gFunctionali ^ I 
(FloatFunc) powt. tabst. qrtf. Fuctorlul, expf* logf. loglOf. 
sinf, cosf. tanf. Secant .^Secant* OoTangeiit t uslnf, aconf. 
atanf, ArcSecant* ArcCoSecant* ArcCoTangent, sinKf, coslif, 
Lunhf. HypSecant, HypCoSecant, HypCoTangent, (FloatFunc) atofi2f 
]; 


// 

// Return the next token in the equation Adiust the 
// pointer to point just itfiLT the token. 
if 

ini Get Token(char **equation. Constant ^value) 
t 

lilt token tokInvalid; 

char *s = 'equation; 

int 1, Width; 

TokenLookup'p: 

// 

// skip leading white space 

// 

while (*n “ ' * II *s = ■\t' II *3 — ‘An’) -h-s; 

if C's ^ ’\0') return toklnvalid: 

// 

// See if *s nwltiies une of tlie token strings 
// 

p gTokenLookup; 
while (p->token toklnvalid) i 
char ‘tnkenString = pOstring: 
slze„l len ^ nrrlenEtokenString); 

If (istmeopEs* lokenStrlng, len)) I 

token “ p >token; vulue >whirh = p->which: 
s len; break; 

I else I 

++p; 

1 


Developer Tools to Support 
Adobe Adobe® Tech oologies 

Adobe provides a complete set of tools and 
services for your development needs. Whether you 
want to integrote Adobe Acrobat® copobiliHes Into 
your opplications, add PostScript® language 
support to your products or create powerful 
Graphics Application Plug-ins, Adobe has the tools. 

These Software Development Kits now available: 

^ Adobo Acrobat Plug-ins 
AiJobe PostScript Latiguago 
^ Adobe Photoshop^* 

^ Adobe Illustrator® 

^ Adobe Prefniere® A Adobe After Effects® 

9 Adobe PageMolcer® A FromeMaker® 

To have infofmotion faxed to you, coll (206) 628-5737 
ond request document 1220. Or visit our web page; 
http://www.adobe.com/supportservice/devrelations 


Adobe Developers Association 

345 Partt Avenue. San Jose, CA 95110-2704 


int GatNuntberToken(char "t?quulltjn* Confltant 'value) 
I 


char 

char c; 

lung tl ig! In " 0; 
float val: 
float divisor; 
int token; 


// keep ihf ncxi diarKHcr in a a^gister 

if iiiicd lo iklcmiitH: vvIkiIht weVt* setn any digits yet 

// ihc value nr the conjoam 

if keeps track of place value at floai digils 

// ihr kind of mimbcf we found 


token ^ toklnvalid: if assume we didn't find a number 
R = 'equation; // piuiu LO siait of string 

c - • H; // gel first iiiar 

// 

// (lather the integer part (jf the constant 

if 

vai = 0.0; 

while (isdigitCe)) ( 

val va 1'10.0-i- (c-' 0'): if shift in the next digit 

I i digits: // rcinemlx^r we found a digit 

r = * ( M s); //get next clvaraeier 

] 


if 

a Ufxlitc the eiint'iit position within the string. 

// 

'equation = s; 

// 

// Try to parse a nunKTie coitstani. 

a 

!f (token ^ toklnvalid) ( 

token " Ge t Nuaib a r Token (equation, value); 

I 

return token; 

I 

if 

// (ictNumbcrTokeii rec ognizees tiunieric ermstants of the forms 
// t»r KF9JM0-9I+ 

// 


fi 

// If we found an integer part, prepare to leium it. 

// 

if (digita) \ 
valueAf - val; 
tnkan tokFloat; 

) 

if 

// Now let's see if there is a tmiling deetnul poiju 
fi and optional digits If so, then this Is a fltwtmg 
fi point constant. 
if 

if (c = ■.’) I 

c ^ * (-H-S j; // skip over decimal fxiint 

divlaor^l.O; // haven't seen fraction part yet 
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while tifidlgltCc)) I 

val " val*!0.0+{c -'0'); //sliifi iji nexid^U 
divisor *= 10: //remember to fbt place vaJuc 

++digits: //we saw another 

c ^ • C++s): // gel mm character 

1 

fi 

if If there were dighs before or after the dccimaJ 
// point, then we liave a valid float. Otherwise. 

// we onl^ saw a ik-elmal point. 

// 

if (digits) t 

value->f “ val / divisor ; //this fixes the place vahjc 
token " tokFloat; 

1 else I 

// We saw only a decimal point. Pbint us back at die decimal point, 
-s; 

} 

1 

* equation = e; // point beyond what we found 

return token; // return what we found 


TokehMode •HowTokcTiNodefiokenNode ‘ieftt TokenNode *tight, 
tnt token) 
i 

TokenNode “node: 

node = (TokenHode *) NewPtrlsi^eof(TokenKode)); 
node->left " left; Eiodp->rtglii = right; 
node->token token; 

return node: 

1 

void FreeTtee(TokenNode ’root) 

( 

if (root) ( 

FtfieTree{root )lefL3 : h'rEeTreG{root“bright): 

Disposeflr((Ptr) root): 

1 

I 

r 

A simple parser tor our opnession grammar. The grammar 
looks like: 

expression ->tertii ( ADD_0P terai )* 

teriD ■>factor ( [ HULTIPLY OP 1 factor )* 

factor ■>SQUARE ROOT factor 

I signed EXPONRRT rector 

j signed 

signed ->MINUS signed 
[ PTJiS Signed 
I gamma 

gatnma > siaiple_value ( FACTORIAL )* 
siiiipie_vuiue’> NUMBER 
VARIABLE 

L£rr„.PAREN expreKslon RTGUT_PAREN 
FUNCTION LEFT_PARKN expression R1GUT_PAREN 
stataaent’^VAHTABLE EQUALS expression 

where (.„)* means tt'pt^ttxl sxto or more limes, and 
[.„] means optional. 


TokeuNade ‘ParseExpression(char **s) 

I 

char 'temp: 

TokanNode *left, 'right, 'node; 
Int token: 

Consturn value; 

node - NULL: 

if Get the first term 
left “ ParseTermCs): 
if (left — mu.L) 
return left: 
node - loft: 


// Get siicccssivc tcm^.sepaiaied by lokAddOp's 
do f 

tenp = 's: 

token = GetTokeu(Atenip, Avalue): 
if (token = tokAddOp) I 
*s ” temp; 

right PurscTerra{s): 

II (tight) 1 

node = NewTokeriNode(ieft* right, token): 
node'>value.which. ^ value.which; 
left ” node: // this makes it lcft-asstH:iative 

I 

1 

I while (token = tokAddOp); 
return node; 


TqkenKode 'ParseTeriii(char “*s) 

[ 

char 'temp: 

ToketiNode 'left, ‘right, ‘tiode; 
int token; 

Constant value; 

node - BULL: 

left “ ParseFactor(fl); 
if (left “ NTn.L) return left; 
node = left; 

// 

// Get successive factors, 'Dicy may Ix" separated by 
// lt>kMulOp's,or they may lie adjacent (Implying 
// multlphcaijon). if we find a tukAddOp, then we 
if Iwc lo unwind: otherwise, an expresskm like 
// “3 - T wtmld be parsed as ' (-7^". 

// 

do I 

Leup = ‘s; 

token = GetTokeniSitemp, lvalue) : 
switch (token) i 
// Explicit mull iply/divide 
case tokHiilOp: 

‘b = romp; 

right - FurseFaclor(s); 
if (right) f 

node = NewTokenNodefleft, right, token); 
node->value,which “ value.whlch; 
left = node; //this makes M teft^associative 
I 

break; 

// Explicit add/siihlRX'l;tkm*l tki implkil multiply. 

// Use the single factor only 
case tokAddOp; 
node = left: 
break; 

if ImpLicit multiply or single facttir 
default: 

fi Try to find a second facsor 
temp = *b: 

right = ParseFaetor(s); 
it (clglit) [ 

// Goi one, so do impikii multiply 

token " tokMuiOp; // pretend there was an explicit multiply 
node - NewTokenNodefleft. right, token): 
node->value,which = kMnltSply: 
left = node; // make ii lcfl-as.stx'iativi" 

1 else I 

// Nope, pist a Single fucior 

* s ^ temp: // put liack the lokens ftirscl-acior gobbled 

node ^ left: 

) 

break: 

I 

) while (taken = tokHulOp): 
return node; 
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// Fiirsci-attof, PaarscNegative. Farscf^'actorial deleted for brevity 
// See ftp site for cimipHc code listing 

ToketiMode 'ParBeSimpleValoe(char 

I 

char Henp: 

TokanJiode 'left; 

int token; 

Constant value: 

left - NULL; node - NULL; 


temp = ‘s; 

token CetTokonfs* fttvaUm): 
switch (token) t 
case tokFioat; 

left “ NewTokenNode(NULL, NULL, token); 
left->value value; 

11 g,Nun)ConBtantB; 
break: 


case lokVuriable: 

left - New'i'okoriHodeCNUU, NULL, token); 
l€ft->vaiue ” value; 
switch (value,which) t 

case kPi; gVariableFlags |= kPiHask; bteak; 
case kE; gVariableFlags |- kEMask; break; 
rase kR: 

// usif^ r implh^ using x and y since r is computed from k and y 
gVarlablcFlaga j” kRMaGk + kXMsf^k t kVHask; 
break; 

cose kTheta: 

// using Uicia implies usUig x and y since thcia is computed from x & y 
gVariableriags |- kThetaMask + kXMask + kVMusk: 
break; 


case kXi gVarfahleFlaga 
ease k¥; gVarfabieFlaga 
case Ml gVarlablt?F]ags 

1 

break: 


= kXHask; 

- kYMask: 

- kNHaak; 


break: 
break; 
break; 


cane tokFunction; 

node ^ NewTokenNode(NULL, NULL, token): 
node >va1ue, which " value.which: 

// 

// if ilu’ function was abO. then convert to a 
// special token so it cm be cvaJieitcd mote 
/f efficienUy, 

// 

if (value.which ^ kFuncAhs) node->token ^ tokAbs; 
token ” GotToken(s, Svalue); 

If (token 1= lokLcftParen) I//Missing left parenthesis 
node “ NULL: 

1 

// hall into pnxessing of paiciliesiicd exprcs^Q 

case tokLeftParen; 

left = ParseExpression(s): 

token = RetTokRn{p, lvalue)://swaUow right paitnUtcsIs 
break: 


case tokRightParen; 

// A rigid paretnhesis means we re doing doing 
if a recursive parse of an expa^ision. In that 
// ease, pretend like we liit the end of siring. 

* s = tejip: // back up so caller finds r^l parentliesis 

break; 

caao Lokliivalld; break: 

d e f au it: //An unexpected token was seen 

break: 

I 

// 

// If it was a function call, then point to the argument. 

// 

ir (node “ NUIJi] node * left; 

else nodc->lefT = left; 

return node: 


TokenNode *FarfieStateiiient(char **s) 

( 

TokenNode 'node, ‘left* ‘right; 

1nt token: 

Constant value: 

// 

// Gel the variable 

// 

token ^ C«tToken(s, fcvaiue): 
if (token “ tokVariable) I 

left = NewTokenNode(HULL. NULL, token): 

1eft->valije = value; 
if {valuc.wbich ^ kZ) 

gVariableFlags j* kFunc 11 nnOfY://"?,=" implies yP Ls valid input 
I 

// 

// Ciel the asidgnttieni token 
// 

token = GntToken(s, lvalue): 

If (token rokAKKign) I // Missing“=* 
return NULL; 

] 

// 

// tkn die expres^n 

// 

right = ParseExpression(s): 

// 

// Bttild titc node 
// 

if (right) I 

node - NewTokenNode(leiL. right, token); 
node*>value,which “ value.which; 

} else t 

node = NULL; 

I 

return node; 


if 

if llcre s the main entry point for die chalk-iigc. 


n 

void Evaluate( 

char 'equation* 
cuiiuL Values *xP, 
conat Values ‘yP* 
const intValues ‘nP 
Results wLJ) 


// nu)l>4crminated equation to evaluate 
// input values tor x 
// input values Air y 
// input values ft>r n 

// prcallocattxl stomge Air (jquatkm values 


I 


char ‘2 “ equation; 

TokenNode 'root; 

Values uFl oa t Val lies; 

// 

// Set up the floating point values of n 

// 

nFloatValues.first = nP-)flrst: 
nFloatValues,delta nP*>delta: 
nFloatValuea,howMany - nP’>howffany; 
if 

if Parse the input equation 
if 

gVariableFlags * 0; 
root = Parsestateoient (Srs); 

if 

if Generate code lo evaluate tlic equation 
if 

CodeGenlroot‘>right): 
MaksDfltaExRcutable(gCodeBase* 32760): 


CallGeneratedCode(gCodRBase+4, xP, yP* nP, 
^nfloatValuoa. w, 
gConstants, gFunctiOOS, 
2.718281020459. 3.1415926535098); 

// 

// Free up the memoiy we allocated. 
if 

DtaposePtr((Ptr) gCodoBase); 
gCodoEasc ^ NTH.!,: 
gNextinst rue Lion NUT.T,; 

FreeTree(root): 
if (gConstants) 1 

DisposePtr((Ptr) gConstants): 
gConstants ^ NULL: 
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// Contains various mutincs used to ppoducc PriwcrPC object code 
// (In tnemory^ lo cvaLuatt; an equation at a range of tnpul values. 

^include <Hemory»h> 
ilfincliidn "Evaluate,h" 


// .Some simple macros for producini; the llowcriX!: instroctioDS in the j^-niraicd 
// code. The otder of the arguments matches the order you'd write those arguments 
// ill asscmhly Linguagc source. 

jfdetine op_addtrD, rA. rB) {0x?C000214 + \ 

(rD«2i) + (rA«ll)) I {rB«U}) 

tfdefine op addlCrD, rA, simmj {OxTBOOOOOO + \ 

(fn«St) + CrA«l6) + Si OxKFE'F)) 

ifdefine ap,b(offnet) (OxABOOOUOU + {of I not b UxyjfFFl'FC)) 

iifdcfirio op^betf0 (0x4e8U0420) 

j^defirie up.bKt^ffset) (0x4^000001 + toffset & OxOBFFFFFC)) 

^define op_blr() (0x4e800020) 

jjfdetlne op_bne (offset) (0x40820000 + (offset A OxFFFF)} 

^define op cfiplwi(rA, uIihiii) (0x28000000 + \ 

(rA«]6) + Cuinim k OxFFFF)) 
Jidefine op_fnhs(f rl), frB) (OkFC 0002]0 + (frlXCZJ)+(t ra<Cl 1)) 
iifderine op^raddsf frUp fiA. frB) (0xlSCDO002A + (frD«2l) + \ 

(frA«I6j + (frB«U)) 

ilfdefine t>p_fdlvs(frD. frA, frB) (0xEC000024 + (frD«2lJ + \ 

(frAC<16) + (frB«U)) 

^define op fmaddaffrO, frA, frC, frB) (OxFjOOOOO:iA + (frn«21) + \ 

(frA«l6) + (rrB«in + (rrC«6)) 
Udeflne np_fiDr(f rlJ. frS) (OxKCOOOtjyo + (frlK<21) + {lrSC<n)) 
#dcftno up^rniuUffrh, frA, frC) {0xKC0O0032 + (frl)«2l} + V 

(frA«l&) + (tr€C<6)) 

fdefine op_tneg(frD, frB) (OxFCOOOOSO + (frD<<21J + CfrB«ll)) 
^define op^feubsifrD, frA, frB) C0xEC00002B t (frD«2l) t \ 

{frA«l6) + (rrB«tl)) 
(OxCOOQOOOO + (rri>«21) 4 \ 
(rA«lb) + d) 

(0x80000000 + (rD«2l) + \ 
(rA«l6) + d) 

(0x7eOg02a6 + (r0«21)) 
f0x7e0903a6 I (rS«2n) 
{0x7e0803afi 4 (rS«2l)) 
(0x60000000) 

(OxDOOOOOOO + (£rS«2l) + \ 
CrA<Xl&) + d) 

^define op_stfsu(frS. d. rA) (0x04000000 + (frS<C2l) 4 \ 

(rA«16) t d) 

define op_£tvu(rS* d, rA) (0x94000000 I trS<<2lJ t \ 

(rA«l6) + d) 

Jdefine op mibUrB* rA. sinin) Qp_uddi(rP, rA. sitirai) 


jIdefXne op lrfl(frD. d. rA) 

#definc up_lw>!(r[>, d, rA) 

^fdeflne Dp„iniir(rD) 
jdefine op_i 0 tctr{rS) 

Ifdefine op iatlr(rS) 

Idefine op nop() 

jdeflne op_strfft(rrS. tl, tA) 


// iw variables iliai are used, nurk tlieni 

// 

if (gVariableFIags B kliHaak) regOsage [regN) ^ 1: 

if (gVariableFlags B kXhaak) regllRagefregxj = 1; 

If {gVariableFtags 8 kVMack) regOsage(rcgYj - 1; 

if (gVarlablcFIags i kHHuijk) regUsage[cegRj 1: 

if (gVariableFlagii B kThetaffask) regOsage [cegThetaJ = 1; 
if (gVarisbieFlags B kEMask) regtfsagelregE] “ 1: 
if (gVariabieFlags h kPiMask) regOsage[regPl] * 1: 

// 

// Aikicale memory ft>r eonstants 
// 

gConstantf! = (float *) NewPi r (gNumConsianln ' aiKC!or{float)) ^ 
gNuiBConsLatiLs ^ 0; 


Alk>caieRegisier 

// AikieateRcgisicr reserve a notvwdaiile register t>r memory ktcatkm 
// to bold Mime value. 

// 

sLalle ulong AlloealeRi?gii;lor (void) 

f 

llit ±l 

II 

// Try a]kx;atjnp a real register. 

H 

for (f=regFrenBaRR; i^rpgMnx: t++) | 
if (regUsageti) — 0) I 
++regUsage[i]: 
return i; 

I 

I 

// 

// Dkin'i work, to use memory. 

// 

return regMentory + riuaiMeBioryVara++r 


llscRegisier 

// UscRegister; Mark a register as in use. If the given rt'glster 
// is a non-volatile rq*ister (not a metm>ry kxation), then incn^meni 
// jt’$ iisagt' count. This is simiLir to ABoejieUegjsier, but when 
// you already liavc the register immlx r 
II 

static void UseReglfiter(ulong which) 

I 

if (which >- regFreeHp-^Re AA which < rogl^ax) ( 

++r egilna go [w)i I cb] : 

I 

1 


r 

Some missing optimizatiomi: 

■ Uxjji unnifliug (” prolxtbly the ini>si impontnt uppoituiiiiy ") 

• Coniiikoii sul>expTession eUniinatk^n 

* [ixample: IVs usiully tisier to compute IxHb eo5(x> and sin(x> 
in a single operation than awnputing them separaieti. 

The trick is rteogni/ing the opportunity;Is a Man. 

•Take advantagi* of trig iikrnbties 

• RciUindani krad/store 

" Sometimes moves values to and fmm non volatile storage wlicii the 
tniervauiig operatiotts dorfl change volatile agisters. 

" Ikiesii't coinhiiie multiply and add into a .single instruct ion. 

• Ncgaik>n sjumld be combined with previous fmiil or labs insimetion. 

7 

11 1 0 n g r e gO K a gn [ 3 2 j ; // noitr/r^ro mt^is register! Jt) is currem ly in use 

II1 ong uumHotnoty Va r^;; // number of icm[>orjrics not in registers 

ulong gNuinCoti^tuntn: 

float *gConstants ^ NULL: 

ulong 'gCodoBase. 'gJ^ext Inst ruction: 


// I'R’eRegisteT, StofcRegister. NonVolatikRegisief have liccn 
// deleted for brevity. See ftp site for full cixie listing. 


l/iadReglster 

// Lj(iadRi!gister Make sum the scHux e rcglster/nh‘mory Is in a real 
// regi-ster If noi/miive it to die desiinaikm (wlikh Is a re’nl 
// registxT) via a Ifs jnstnK'iion. 

II 

static along LoadRegister(ulong source, ulong destination) 

I 

ulong displacoBient: 

if (source >“ regMemory) f 

d isplaccmoiit ^ ('Joureo rngMi'tntjf y) *4 ; 

‘ (gNcx11 rifi t r' uc 1 1 oii++) 

op_lfs{tiesiirmtion, displneomcnt. regVariablcBase) : 
rsUirn deHtinatlon: 

I else I 

return source: 

I 


InitOnMien 

void rnltCodeGen(ulong VodnStart) 
i nt I: 

gCodeBase - codeStart: 
gNextinstrucrion = codeStart: 

for (1-0: i<32; i++) 

regUsa ge f i 1 “ 0 : 1/ mark reKlsters as m ji in lese (i.e. available) 

// put constants in (ivcriliw register pcxil 
nntjiHfiiiini yV,irs gNuaiConstanta: 


TeinpofaryRcjaift 

// TemporaryResuh: Generate a (real) rc-g^ter niimlKT to be a destinatiiin rtpstcr 
// for some liutiruciion. tlic do^uuttioii has already Ixren deiemiiiicd and Ls in 
// ‘which". 

// 11 ‘ wlikir is mcinor\'. liico use a volaiiJc register, which will be siored later. 

// 

fifatic ulong TeaipQraryRcxult(along which) 

I 

if (which y~ regMeoiory) re I urn rpTcipRcuuU; 
else teturn which; 

I 
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SUjrrRcsult 

// StorcRitsult: the si-cond p;m of Tanpt^rjryKesulL. U ItmpararyRtsuli was passt^d 
// a mcmciry icKulloivihcn Uiis funcikm lakes care of actuary storing the rc^t 
// (after it tias been pui in llic tempomry volatile itgetter). 

// 

static void SroreR^suU tnlong which) 

I 

if (which >= regHcnioryJ I 

SI o r e Rt*gi s t e r (wh 1 c h * f pTeapResu it): 

I 


MovcRcgisicr 

//MoveRcj^jstcr Miivc; iicgislcf lii memory rtgister to it‘gisicr,or memory to RtjisleT. 

// 

static void MovcRogistGr(ulong destination* uiong source) 

I 

if (source >= tegWax) I // Source is memory 

if (destination < regMax) 

LoadRegister (source* defitinatlon): 
return; 

) 

if (dent Inn Iton >“ rogHnxJ [ 

// t>{rs£i nation is in memory, so geiieiate a sds mslruoion 
SloreRegister(destination* source): 

1 else t 

// Sourec and dcHination or nrgbiicrs* so Rcnciate fmr insinittion 
* CgNesE 11 net ruction tt) op_fair (dcstliialion* aourcc); 

I 

I 


Calll'ynctjon 

// C^ltPunctkm: a fiuKtion. Pui (Ih: dcM:ript<>r pointer into R! 2 and 

// use Itie fimaion glue at n to iump to the desired rouline. 

// 

static void CallFunctlnnfuiong which) 

I 

long dl splacemcn L i 
// 

// Ijoad the pointer U> the desired funelion into rl2 
U 

difiplacesmnt - whlch*4; 

MgNGXtInstructionU) = 

op lwx(rF!gFunrtl£jnGUjn* d iaplaccntcnl. rcgFunctiofiKase); 

// 

// Ccnemie a bl instniciion to the glue at ttii‘ start of tlic gcneraied code. 

U 

displacement = (uXong) gCodeBaee - (uiong) gNextlnKtrurtloni 
’ {^extlnstructlnnH) = op bl (displacement); 


Inputs: 

tiyo/t (sub)trec to gtnenae code for 

rcT^uli Register desiitd regbter for result <0 = any) 

Restill: 

Register containing result If resuliRcgisier was non /cro, then 
this will be the same as rnsiili Register. 


Gxlctkiflree 


int CodcGenTree(TekenKode *root, int resultRegiater) 

I 

char ^opname; 

along temp, teinp2, nrgt, argZ: 
int result; 


if (root ^ NULL) t 
tcLurn 0; 

1 

switch (root->token) 1 
case tokFloat: 

// Stuff the constant in memory in the first part of the overflow register area. 
gConstantnlgNumConstanis] ^ root->viilue.f; 

// [f the result needs to go into a speeillc icgister, then bail that regbier from 
// nveinory. Otherwise, return an overflow regbter number (whidi will get 
// loaded into a tcm|x>^rary regiMtrriust before being used). 
if (resultRegister) i 

ff tixplidtly move value ttj a given register 
result = resultRagintfir: 

LoadRcgintert regHeraory + gNumCoTistaTits, 
rosullRegister); 



Create bar codes in any Windows or 
Macintosh program quickly & easily 
with Rivers Edge bar code fonts. 




TrueType & Postscript Fonts 

Edsy to Usfl - - - 

30 Day. Money-Back Guarantee 

Choose from: ' ■ 

Code 19. Code 91* Code 128* 

Int 2 of 5* Codabar, MSI-Pleosey, 
PostNot UPC/EAR/ISBII ..... 


12345* 6789tf s 


Attaches to Keyboanl 
Plug & Play fof Wlndows/Mac 
Easy to Use 

SZ29 - Wand Reader-Basic 
S235-CCD Reader 
$485; Laser Reader 



I 


I else [ // Tell ciillcr where the value is so ibi'y i^an fetch it 
renulf = regRenory + gNumCoiistunts: 

gNuaCoiis t ua ts++: 
return result; 

case tokAddOp: 

temp = CodeGenTreefroot'>left, 0); 
renp = NonVolnr nnRegisier(Lentp): 

// moke sure it’s in o non-voLitilc rcg. 

Lenp2 = CodeGenTreetroot) right* 0); 

// stj wc can cvaluaic .second arg 
FreeRegister(temp); 

FreeRegister(temp2); 

if {resultRegister} result “ reniil tRrg I fU nr; 
else rnsuU ” AllueutcRegister (): 

arg] LoadRogiBier (temp, fpTcmpl): 
arg2 = LoadRegister fpTemp2); 

if (root >value.which ™ kAdd) I 
* (gfJextInstruction++) “ 

op_fa(ids(TeniporarvResult(teauit] * argl* arg?.) : 
I else I 

*(gNextlnstrurtion++) - 

op_ff;iibK(TempornryRct»ul l (result), argl* arg2); 

I 

StoreResult(result) ; 
return result: 

case tokMulOp: 

temp = CodeGenTree(root->1 eft * 0): 
temp = NonVolnt lleReglntCr(lcnip); 

// make iMire it’.s in a non volatile rcg. 

Lemp2 “ CodeGenTree (root->right * 0): 

/f m we can cvajuaic sccifjk) arg 
FreeRegisterttemp); 

FreeRegister(teifip2): 

if CreEultRegister) resiitr = renuURcglatcr; 

else rnniilt “ AlloealcReglster(): 


August 1997 • MacTech 


Prcx^kammhr's Chaittnct: 


61 






























argl ** ioadRegister(teiDp< fpT&ntpl); 
flrg2 - LoadRegister(teB3p2. fpTemp2): 
if (rofttOvalye.whicii KKiiitlply) \ 

* (gNcxtTriatructlon++) ^ 

op_fiiiuls(TemporaryResult(result)» argl. arg2); 
) else t 

* (gNextlnstruction+'l") = 

op^fdivECTentpararyResuit (resault), argK arg2); 
I 

StoreReault(result): 

return result: 

case tokPoverOp: 

// second aigumcnt, piic Ln any register 

temp * * Code<IenTree(root->right, 0): 

// nuke sure it's in a non-vrdatik reg, 
temp “ NonVolatileRegister(temp): 

// Kainate first argumenu pul into IpAqjl. 
CodeGenTree(f<}ot'>left, fpArgl): 

// Move second argument Co fpArgi If argument didn't require a 
// funciion call, we coukl have pm second argument directly inui fpArgZ 
HoveRegisterCfpAcgZ, temp); 

FreeRegister(teiiip): 

// (jdl power funaion 
GailFunction(kFuncPower); 

// Return result in desired register 
leiap " fpReault : 

if (reaultReglster fiifii resultRegister 1“ temp) I 
MoveKegister(resultRegister, temp); 
temp = refiiiltRegintor; 

1 

return temp: 


default: 

// Shoukl never get here, 
return 0: 

1 

// Slmuid never get here, 
return 0; 

1 


CodeCaiRTheta 

// if r or theta (0 Is used to evaluate the equation, generaie some code 
// to set tip their values based im die values of x and y, 

// 

Static void CodeGenRTlicin (void) 

1 

if (gVariableFlaga h kKMask) ( 

// r = sqrdCx'x + y'y) 

*(gNextInstruction'H') = Qp„fmuis(fpAigl* regXi regX): 

* {g^extluetrtiction'H') “ op_fKiadde(fpArgl * regy, regY, 

fpArgl): 

CallFunclion(kFimcSqua roRoot): 

HoveRegiEter{regfi, fpRea ult): 


if (gVariableFlags kThetaKesk) I 
//JRB correction • theta = aiMi2<y,xX aian2(x,y) 

MovoRogisterlfpArgl, regY): 
MoveReglster(fpArg2, regX): 

// end correction 
CallFutiction tkFuncAtan2): 
MoveRegistertregTheta, fpRonuli.): 

J 

I 


case tokNegate: 

temp " CDdeGeriTree(root*>left» 0) ; 

FreeRegisterttemp): 

If (resultRegister) result ^ resultRegister; 

else result ■“ AllocateRegisterC): 

argl " LoadEegiEter(teiHp* fpl'emplJi 
* (gNext Instruction’H’) - 

cip_fneg(TemporaryResult (result), argl): 
StoreResult(result): 
return result: 

case tokAbs; 

temp CadeGenTree(root‘>left. 0): 

FreeRegistsr(temp): 

if (resultRegister) result resultRegister; 

else result ^ AllocateRegi8ter(); 

argl “ LoadRegisterftenip, fpTeinpl): 

’ (gNext: lust met iou++») = 

op_fabs(Teropora ryResult(result), a rgt): 
StoreResult(result): 
return result: 

case tokFunction: 

// Evaliytc the argument Cmoi->lcfi:), putting it in fpl. 
temp = CodeGcnTrGc(root fpArgl): 

// Qdl die function 

Califunction(root ->value.which): 

// Put the result in the desired location 
temp = fpResult: 

If Crosiil tRegister kk tesultRegifiter f= temp) I 
MoveRegislorCrenultReglnter, temp); 
temp = rcuultRegister: 
t 

return temp: 

casn tokVariable: 

switch (root'>value,which) ( 

case kPr: temp - regPi: break: 

case kKr temp regR: break: 

case kH: temp = rcgR; break: 

case kTheta: temp ” regTheta; break: 
case kX: temp ^ regX; break: 

case kY: temp * regY: break: 

cane kN: temp ” regU: break: 

I 

if (resultKugistor hU resultRegister temp) I 
HoveKegisterCresultRegister, temp); 
temp = resultRegister: 

) 

D s eRegi s t e r C t emp): // balance IrecRcgistcr when tliis vahic is used 

return temp: 


CbdcGcnStoreResiill 

f/ Gmeratr code to store one equation result plus the variables 
// used to produce that result. Assumes that the wP register points 
// lo 4 byics RFFCIRE the locaiion to start storing (so we c:in use the 
if store-witli-updaLc instructions). 
if 

static void CkideGenStoreResult(ulong result) 

( 

// Store equation result 

•(gNextinstrue Lion++} = op_Etfsu( result, 4, regResults) : 

// Store X 

* (gNextlnstruction-H') » op_airau(regX* regResults): 
if (gVariableFlags & kFunctionOfY) I 
// Store htrth y and n 

MgNextTnetructionti) “ Op_erfsu(regY. 4, regResults); 
MgNexi Instructlon+t) ^ op stwu{regNInteger* 4* 

regResults): 

) else ( H Skip over y and store n 

• (gNextIristniction++) op„uLwu (regNToteger, 8, 


QxIcCknlooptnii 

// Clencnttc crxlc to intttali're the loop variables. Ij^ad the firsi value, load the couiiL 
// (ht>wMany); ilien branch lo the te5t pan of the kwip f after the htxly of the ItKjp), 

// Since we don't ktiow where the test will be, wc just skip an instruction word and 
// will insert the branch when we generate the teiit. 

// 

fiLatlc void CodoGenLoopInit(ulong variabieFlags, ulong 

**xRrjqnch* ulong ’^yBranch, uleng **nBranch) 
f 

// f icncratc the loop for x firs! 
if (variableFlags b kXMusk) [ 

*(gNextInstruction++3 - ep^lfsfregX, 0, regXValueR): 

// X - xP'>lirst 

* (gNext Tnfitruction++) ^ op_lwx(regXCourit , 8 * regXVulues) ; 
// xCoimt = xP->howMany 

‘xBrench = gNext Instruct loti; 

// remember branch address 
‘(gNextlnEtruction++) = op„oopC); 
if win be patched laur 

I 

// Now generate the Untp fitT y, IF funcikm was of die fonn 
if ((vatiablcFlagn A kFunctlonOfY) £■& (variableFlags 6 
kYHask)) ( 

• (gNext Ins true Lion-E+) “ op_1fs(regY* 0* regYValues): 
if y = yP->rirsi 

*(gNextTnstruction++) - ap_lwx(regYCount, 8, regYValues): 
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// yCcKitii = yP'>JitJwMany 
•y Branch * * ^ext Inst ruction; 

MgNextInstructlonH) “ op_nopC): 

// will be patched later 

I 

// And lastly, n. N is a bit differaU since we maintain 
// Iwjth the integer and Jluatlng poini values simultaneously, 
if (variabieFlags h kNMaak) 1 

*(gNextInstruction!4) = op_1fsCregN* 0, regNValues); 

// n = nFluat->fif7iE 

* (gNextInfitructlon++) ■= up_lwa(regJJlnteger, 0, regNIntValues) ■ 

// niniegcf = nP >llrst 

* (gNex tine true iion++) “ op_lwz(regKCoimt, 8. regNTntVal uesj: 

// nCount = nP>howMany 
'nBranch “ gNextInstruction; 

* {gNext Inst rue t ionH) = op nop C); 

// will be patched later 

\ 


CotkCienfjOopHnd 

// Gcuciatc the itcniiion step and test/bianch ftir the variable loops. 
if Just before wc generate Ihc test/branch instructions, patch up the 
// brattch instructions inserted by CodeGenl/yopInit. 

// 

// the general tbrm generates something like: 

if itefaii<m: x +- xP-xlelta; 

if KChnnt—; 

if test: if (xGouiu 1^ 0) goto loop body 

if 

if wJiere twp body is the instruction following the forward branch ihai gets paiehed. 
if 

statle void CodftConT.oopEnd(ulong variableFlags, along 
‘xBranch* ulong 'yBranch. ulung *nBranch) 

ulong urfsot; 

if Generate tlie part for o. Remember that we miKi inaement both ihe integer 
// and fkKUktg point values of n. 
if (variableFlflgn A kNHoskJ ( 

* (gNextlnatroet ion-H-) op_lfB<fpTefflpl ♦ 4> regNValues); 

// get nFlnaiVkluesr>dclta 

* (gNoxl Iiistruetion++) op_faddsCregN, regN, fpTettpl); 

// inm-ment n (float) 

* (gNext Ins tract iori++) “ np Iwz (rfigTntTeaipK 4, regNliitValues); 

// get nP >deiia 
‘t gNextlnstraction 11) - 

op addfrpgNTnieger, regNinteger. reglntTempl); 

// increment n 


• (gWext In struct 100++) “ op_XUbl CrogNCoant. regNCTouni, 1); 

// tiCount— 

offset “ (int) gNext Inst met ion tint) oBranch; 

'nBranch = op b(offset); 

// patch branch at start of loop 

•(gfJextlnstruct ion++) = op_etapIwi(regMCount, 0); 

// nCoant==0? 

offset = (int) (nBranch+i) * (int) gNextInsttuctlon: 

*CgNextInstruction++) = op_bne(offset); 
a if not. t)randi to kxjp bixly 

1 

if Next comes y, if a loop was generated Ibr it (l.e, equation was ''z=..") 

if ((vatlableFlags & kFuncLionOfY) && (variableFlags & kYMask)) 

I 

*{gNextInstruction++) = op_lfs(fpTerapl* 4, regYValues); 
if get yP >dctta 

• CgNext In struct ion-ft) = op fsddsCri^gY* rcgY^ fplcmpl) ; 

// ittotment y 

• (gNextInstruction++) - op_subi (tcgYCount * regYCotitit, 1); 

// yCouni— 

offsM ^ (int) ^ext Inst ruction - (int) yBranch; 

■yBranch = op_b(offset): 

// patdj branch at start of loop 

*{gNextInstruction+t) ^ op cmplwi(regYCount, 0); 

//yCoani = 0> 

offset = (int) (yBranch+!) (Int) gNEXtlnstruction; 

* {gKex 1 1 nst r u r. 1 1 on++} = o p_b ii e {o f f set ]; 

// if not, branch to loop body 

I 

if Ustly comes X, 
if 

if (variableFlags k kXMaak) \ 

• (gNextlnstructionH) ^ op_l fj? (f pTumpl. 4, regXValues): 

// gctxP->delta 

’(gNextTnstrnction++) = ap_Iadda(regX. regX, fpTempl): 

// increment X 

* (gNextinstruetion++) op_subi(regXCount, regXCoimt» 1); 

// xCount— 

offset = (int) gMextInstruction ' (int) xBranch; 

•xBrench = op_b (offset); 

// patch bnmdi at start of kMip 

• (gNextlnstrurtIon++) ” op^dnplwKregXCount* 0); 

// zCjoUfit = 0? 

offset = (int) (xBranch'1‘1) - (int) gKext Inst ruction; 

• (gNext Ins true tion++) = <jp3ne<offset) ; 

// if not , hnuidi to loop body 

I 
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// build up a function that loops tiver all the variable input values, evaluates 
// the fimOMm, and sion^ ibe nrsults. 

// 

// If ihi* loops were written in C, llicy d lodt like this: 

// for (x=xP^>fifst, xQHint=xP->iiowMany; // lotip initialiraiion 
// xCount != (y, // Uxip condition 

// K-i'=xP->della, xO>unt—> // ileniiioii step 

// I 

// evaluate and stonr the result 

// \ 

// 

void CodnGenCTokenKode *root) 

{ 

uiong result: 

ulong ■genemtcdCDde; 

ulong *KBruneh. ^yBrnnch, 'nBranch: 

gene ratedCode = (ulong *) KcwPtr; 


) 


if (generatedCode !- NULL] [ 
inltCodeGerL£g€nerat€dCode) i 
// 

// Gaienite (he pointer glue for making indiRct function calls 

// 

* (gNextlnstruction-H-) - f>p_lwz(regRQ. 0. 

rngFunctionClue): 

//lw/fO,(Krl2) 

* (gNext Tnstcuction++) “ op_XwKCrcgTOn. 

rogFunetionGlue) i 
//Iwj'rl, d(rl2> 

* CgWextlnalrLtct ion++} = op intetr(regRO): //mterrO 

MgNextInstruciion++) ' cip_betr()j //betr 

// 

// (ienemic llie riuiciion prolpg — save the link register 
// 

' (gNox t Inst r uction 1+) - op_jnl i r (regliavndLR): 

// mHr rl5 
// 

// Ck‘ncr:ite loop initlali^nion ftir any varkihlL's that arc 
// micd to evaluate dw function 
// 

CodrfkiriLoopInit{gVarlableFlagB, fcfxHTUTuli, ivyBtanch, 

&nRraftch); 

// 

// If r or iheU arc ustxl to evaluate the equatiim. then compute them 
// from X and y. 

// 

CodcGenRTheta0: 

// 

// Cknemte ibe code to evaluate the equatimi. The cqualiofi can be pul 
// in any rcglster. Ihit make sure it ends up in a real register (mil memory). 

// 

result - CodeCeuTreeCrcm(, 0): 

result = LoadRegister(resull* f pResult J: 

// 

// (k:ner:ate loop initialization for any variflhh:s tliat _arc ruu_ used 
// to ctvaluaie the function, litis fust caicfcs the rx’sull to be stored 
// several limits in a row. without re-cv:i]uatiiig it. 

// 

GodeGenLoopinii (gVur iabloFlags ^ (kJtHask+kYMask+kNMusik), 
StxB ranch. ^yBratieb. ^iii Bra rich): 

// 

// Ckmcratc the code to store one result 
// 

CocleGoiiSI or t'Rnnul t (result) i 
FreeRegisLet ( rr^sul t); 

// 

// Cioicrate tiie iteration and test parts of the variable kxjps 

// 

CodoGenLoopEnd (gVariableFiags (kXHniikl kYHask+kNMask). 

xBranch, yftrench, nBrauch): 
CodeGenLoopFndigVariableFlags, xBranch, yBranch, 

nBrutieh) : 


// 

// (iemiate tlte function epilog — restore link regisieT and return 

// 

*{fiN«xtTnstruction++) = op^ntJrTrcgSavndLR): 
//mtlr fl5 

* (gNoxlInstriJctionl 1) ^ op_bir(); 
f/Ut 
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CallGeneratedCode.c 

// 0)n(!3ins a gtiK’ nwitint; iml t-aiJ Ihc hiwcrR: ttxlc pTxxJiictil 
// by (xKjctkri.c 
// 

finclude '‘EvaliiaT.e.h* 

typcd(?r struct 1 

urvs I lotted longsuvedSF; 
unsigned longaavedCR: 
unsigned iongsavedLR; 
unsigned long reserved 1: 
unsigned Iongreserved2; 
unsigned long savedTOC i 
I linkage: 

typL'clef struct I 
L1nkd ge 1in ke ge t 
long arguments [B] ; 
long savedGPR(2oj: 
double savedFPRfial 
I StackFraron: 

enum I SluckPraneSiEe - siseof (StsckFraine) i: 


// scl ;isjdf maximum rcHim Tor called function.^ 
// rl5-^t (bst kicutkm m m>t used) 

// fpl4-fp5l 


(^UCk'iimtcdikKk- 

// Saves itgislcts and sas up parameter area for generated todc.nie generated c^xle 
// may save the link rcKt^rr in the linkage area. Since the generaied €<xle never uses 
// IhcTXKI rc}jtster itself, it is sufficient to save and restnre it hent in case the 
// j*encnited ctMte calls to a diflereni fmgmenT. 

// 

asm float CallGeneraiedCud^C 

register void *addr* // first iusituLtioti to c^tecute 
reglEter const Values ‘xValues, 
register const Values ^yValues, 
register const IntValues *nIntVahies, 
rogistEc const Values 'nValuns. 
register Rosulrs 'resultsPtr, 

register float ^eonstarits, register void *functions* 
register float eValue* register float piValue) 

// 

// Save our return address andTXM^ 

// 

mfIr rO 

Rtw r?.Linkage* uavedtOC(SP) 
sLw rD,Linkage*savedLR(SF} 

// 

// Make new stack linmie 
// 

stwu SP.- SteekFrameFizeCSP) 

// 

// Save nnn-volatilc Hl'lts 

// 

stfd fpH.StackFranie*sav€<lFPRlQj (SP) 
stf d fp 15, StackPeame * sa vedFPR [ 11 (SP) 
fitfd fpl6*StackFrame.savedFPRf2l(SP) 
stfd tpi7,StackFramo*savedFPRbl(SP) 
stfd fplSiStarkFramo.savedFPR[4]{SPj 
fitfd f p 19, Si nckFratnc. savedFPR [5] (SP) 
s L f d f p20 1 S Luc kFrauie. savedFPR [ 6J (SP) 
stfd fp21,StackPramc.savedFPR[7J (SP) 
stid fp22.StackFraTne.&avedFPRi8] (SP) 
stfd fp23 ,StackFraTDe.BavedFPR[9l (SP) 
stfd fp24.StackFLaine.flavedFPR[lDl (SP) 
stfd fp25 pStflckFratnn.savedFPR [ 11 ] (SP) 
stfd fp26 ,SrflckFrfimc*Bavc:dFPR [12] (SF) 
stfd fp7./*SLackFranie*aavedFPR[li] (SF) 
stfd fp2apStackPrai!ie*aavedFPRLl4] (SP) 
stfd fp29.StackFrame.savedFFRilsi(SP) 
stfd tp30*StackFraine,savedFPR[16l (SP) 
stfd fp31,StackFraae*eavedFPR[17l(SF) 

// 

if JSavc noivvniaiile ^!PR^ 
if 

atv rn*StuckFraHie,savedCPR[D] (SP) 

stw rl4*StackFraiie,savedGPRLlJ (SP) 

stw rl5,StackFra[De*£avedGPRf2] (SP) 

stw rl6.StackFtaiiie.eavedGPR[3l [SP) 

etw r 17 , StackFrame. eavedGPR f 4] {SP) 

Btw rlfl,St3rkFramo*navfidGPR [S] (RP) 

nrw r l9.StackFra[iio*eavcdGPR[6l (SP) 


Got Windows?^,^^ 


Then what are you waiting for? 

Mac 2 Win is die sointinn for porting 
Mnc applications to Windows - TQDAV! 
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stw r20*StackFraine*savedCPR|7l (SP) 

stw r21,StackFrame.sav^GPRfSl (SP) 

Stw r22*STar:kFrainpt*savf!rfGPR[9i (SP) 

Rtw r?3*StackFcainc,GavcdGPR[r0l (SP) 

slw t24*StackiYaine.savedGPK[nj (SP) 

if 

if PiiiSS lupul panuiicicrs tu gcjicraicd uidc 

if 

fmr fp30,eValue 

fmr fp3i*piValuR 

ipr r[3*f!f>nstants 

mr rl4 * fuui: Liohfi: 

ntr rl&,x Values 

Ur rl/,yValues 

mr rl8.nValues 

mr rl9*nIntValues 

fiubl r20 * resiil t sPt r * 4 // M;t up result'M 

if 

a C 4 II function at addr 

fi 

mtt’tr addr 

bl GoToCTR // thi^ sciEi up U 10 rcium to m 

fi 

a Restore (tPRs 

a 

1 rl 3 H SlackFranc. savcdGPR [0] (SP) 

IwK rl4.StackFraffie.savedGPRtl](SP) 

Iwz rl^iStackFrajne.savedCPRL2J (SP) 

Ivz rl6*StackFraine.savedGPRt3] (SP) 

Iwz r17,StackFrame.savedGPR[4](SP) 

Iwi rlS.StackFrswe.savedCPRfS](SP) 

Iwz r 19. StackF raiie. sa vedGPR [ fi j ( SP) 

lw7. r^O.SiackFraaie.savcdGPR[7] (SP) 

1w7 rZl .SiackFraHio.aavedGPR[8l (SP) 

Iwz r22 ,SLackl!'raaie.SavedGPR[9] (SP) 

iwK r23 * StackFrame.savedGFR i 10J(SF) 

iWK r24»StackFrame.savedCPR[Uj (SP) 
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Evaluate.h 

// Proioiypes deleted - see code on ftp site 
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// 

// Resioa- l-PIts 
// 

1 fd fpl^.StackFfame.savedFPRlOl(SP) 

l£d fplS.SlarkFraBie.fiavedFPRlH (SP) 

Ifd rpl6.StaekFtafiG*savcdFPRl2l (SP) 

Ifd fpl7.StackFrarae.savedFPRl3HSP) 

Ifd fp 18. StackFcame. savedFPRl4il (SP) 

Ifd fpig.StackFreme.savedFPRlsHSP) 

Ifd fp20.StackFeaine.savedFFRl6i [SP) 

Ifd fp2UStackFi:aEie.savedFPRl7l (SP) 

Ifd rp22.St:atkFraBe.savedFFRl8l (SP) 

Ifd [pZI.SLaekFraKO.savodFPRl^l(SP) 

ifd fpZ4,StackFraiao.savedFPR[10l (SP) 

Ifd fp25, StackFrai&e. savedFPR [11] (SP) 

Ifd t'p26*StackFraBie,£avedFPR[12] (SP) 

Ifd fp27.StackFr:ame,s3yedFPR[13] (SP) 

1 f d fp28,StaekFtame.savedFPR L UJ(SP) 

Ifd fp29.StaekFratne.savedFPR[15] (SP) 

Ifd fij30*StaekFraiite,uavedFPR [I6l (SP) 

ifd fp3l*SLackFiraine.aavedFFR [i?] (SP) 

// 

// Unwind stack frame 
// 

addi SP,SP.Stack?rameSis'e 
if 

if Rest tire TtK' and reium 
if 

Iwz rO,Liiikage-savedLR(SP) 

Ivz r2,Liiikage.saved'rOC(SP) 

mtlr rO 
Ur 

GoToCTR: 

betr 

1 


r - 

These arc types and funetjon pmeotypes used intemalfy 

--------7 

extern ulong gVariabTeFlagfs; 

extern nlong gNtnnConstant^: //Number of constants ftMind/staried 

extern float 'gConstante; //Array of constant values firornequaiitm 

extern ulong ‘gCodeBase: //Addressof start of gpnerated co^ 

extern ulong ‘gNextInstruction: 

// Where next generated instruction will be stored 


union ConsLant [ 

float f: //a float constant 

1 on B wh i c h; // which one of a group {kVariable; IcAddOp^ cicd 

\\ 

typedef union Constant Constant: 

struct TokenNode { 

Int token: 

Constant value; 

struct TokenMode Meft: 

struet TokenU 0 de 'right; // 1 inused for unan' operatoni, functions 

): 

typedef struct TokenNode TokenWode: 


// 

// Hetnro the ncDrt token in the equation. Adjust the polnler to 
// point just after the token. 

// 

enum I 

tokFloat, tokUeftFaren, lokRlghtPeren, 

tokAddOp, tokHulQp, tokPowerOp* 

tokNogate. tokAbs, tokRootOp, 

LokFactorial, 

lokFunctlon, //In, sin, tan, etc, 
tokVa riable, // x»y, f, f etc, 
tokAssign, //= 
tokinvaiid 
I: 


// indices for the various luoctions 


enum [ 

kFuncPower, 
kFuncFactorial. 
kFuncLogTen, 
kFuncTan, 
kFuneCr^t, 
kFuncArcGos, 
kFuncArcSoc * 
kFuncArcCot♦ 
kFuncTanh, 
kFuneCoth, 


kFuncAh s, kFuneSgua reRoot * 
kFuncKxp, kFuncLogN, 
kFuncSin, kFuneCos, 
kFuncSec, kFuncCsc * 
kFuncArcSin, 
kFuncArcTan. 
kFuncArcCfic, 
kFuncSInh, kFuncCotrh, 
kFuncScch, kFuncCsrh, 
kFuncAtanZ 


h 


// Values of‘which" for mLsc. tokens 
on urn f 

kPToat, kTntpgor, kLeftPareri, 

kRightParon, kAdd. kSubtract, 

kKultiply, kDivide, kExponent. 

// "variables" 

kPi, kE, kR, kTheta, kX. kY, kZ, kN, 

kEguals, kInvalidToken 
I; 


// C.onsiants for bits in gVariablcFIags 
nnum I 

kRHask - 0x0001* 

kThetaMask ” 0x0002* 
kXMaiJk = OxOOOA* 

kYMask ” OxOODS* 

kNKask = 0x0010. 

kEHask - 0x0020* 

kPlKask = 0x0040* 

kFunctionOfY^ 0x0080 

1 : 


// r was used in the equation 
// t was used in the equation 
// X was used in the equation 
// y was used In the equation 
// n was used in the equation 
if e was used in the equation 
// p was used itt the et^ion 
// funciioti was of the fimn ■hE='' 
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RepFinted by permissjcm an UFS, Inc. 


// The variousf mtdj?eT flaatjcig point registers uined 
enuiD I 


re^RO 

Wf 

0, // used for function calls 


regTOC 

= 

2, // TOC is pointer to globals 


regFunctionClue " 

n. 


regVariabieBase = 13., 

// points to (temporary) values storexl in memor>' 

regFunctionBase = 14, 

// points to array of function ptjinters 


regSavedLR 

— 

15 , // we save caller’s IJt here 


regXValues 


16. regYValues " 

17, 

regNValues 

- 

13, rogNIniValuea 

19, 

regResults 

= 

20, regNIoteger 

21, 

tEgXCoimt 


22, regYCount * 

23, 

tegMCournt 


24. 


fpResult 

= 1. 

// results always in fp 1 


fpArgi 

= 1. 

// first tp argument in fpl 


fpArg2 

- a. 

// set^nmi fp argument in fpi 


f pTemp1 




fpTenip2 

= 4. 



fpTempResult 

= b. 



reglntXempl 

= 4. 

// a volatile integer register 


regFreeBase 

- 14, 

// fuxi non volatile register 


regMax 

= 32, 

// number of fp rcgi.stcrs 


regN 

- 25. 

regX = 26. regY- 27. 


regR 

- 28. 

regTheta * 29. regR” 30. 


rogP] 

31. 



regf^eraory 

= iOO 

// fake register nvimbcr for memory^ loc.itions 


El 


Want to know what products are 
available for MacOS 
development? Check out 
Developer Depot ™ 
<http://www.devdepot.com> 


Automated testing 
just got easier: 

query ^ controi the interfece 


Player 1.1 (vonMwt Tt.o anippod Aug. I9fl4| 

Likn a player piano. Player mimics user input. 



$95.00 

eoday MBG 
Runlinffi: S25 ea. 

"An excellent 
tool for 


testing?” 


Your scripts can choose from menus & pop-ups, select radio 
buttons, type text, determine the name of the frontmost window, 
the state of a checkbox, etc. Far AppleScript and Froniier. 
Complete details and free 30-day trial version on our website. 



The simple way 
to handle 
complex text™ 


Text Machine (vQfSKHi 1-0 to »tiip qa 1^7) 




$95.00 

SO-dayMBG 


see website 
for discounts on 
pfe-relesse 
versions 


Give FnjntitT Search and replace patterns of text using simple 
and AppleScript keywords instead of cryptic grep syntax. 
the power of Cleanup and convert text for web pubhshing, 

e-mail management, DTP, database import, etc. 

Version hO will supF>orl AppleScript & Frontfor, 
Version 11 will add a dialog for Open Doc. 


^20A Main Street 
Acton, MA 01720 
508-266-2885 

playar#pr©fab.cam 


Prefab 

SQFTWARtptMa- 
WWW >prefab,com 


Dilbert" hy Scott Adams 



GKEAT GRANDDAD DILBERT 


DOGBERTIO! LOOK 
WHAT rVE INVENTED'. 


SLICED 

BREAD? 



01997 United Feature Syndicale, Inc. (NYC) 



THIS IS THE GREATEST 
THING SINCE ...UH.. . 
SINCE ...UH . . . 



UNSLICED 
DREAD ? 


I 
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hy MacTech Editorial Staff 



The Future of MacOS Printing 


An Open Letter to Apple COMPirriR 

Apple has announced an end to its airreni siiualion of 
supportin^^ I wo aHriplctdy different printing architectures 
under MacOS. This much seems sensible. However, they have 
decided to keep the old, rickety QuickDraw architeaure that 
has been hacked and paicfied and tweaked and munged and 
generally abused over die past thirteen years into doing things 
it was never designed to do. lliereforc, dumping the next- 
generation QuickDraw GX arehilecTure that would have taken 
MacOS printing into the next century- This ietter explains why 
I diink Applets choice was the wrong one. 

Let's get one thing straight: Lm no fan of a technology, 
no matter how emd it sounds, no matter how' many years of 
work were put inlo it, if it doesn't actually help people get 
their work done. QuickDraw GX printing solves real 
problems for real users. 

Fvery few days without fail on the USENET newsgroups I 
frequent, somebody asks how to do double-sided priming on 
a single-sided printer. The easie.st solution Em aware of is my 
own freeware Duplex Helper. Tell it how your printer prinUs 
(on tile upper or lower surface of die paper, output face up or 
down), and it automatically works out which pages to print 
(txld or even) and in w^hich order (forward or reverse) so you 
don't have to shuffle any pages around. It wf>rks with Ixith 
PosiSeritn and non-PostScript printers, and with just about any 
application that can print. 

The only way to provide ettuivalem functionality without 
GX would be to reinvent this feature in every printer driver, or 
in every application, or Ixith. Why do you think so few of them 
bother? I even see Micro-soft Windows users asking for a soliilkm 
to this prolilcm, and not finding one! 

[ recently did a development job for a company that sells 
print server software — diey needed an extension to install for 
their Macintosh diems that would obtain infiyrmadon about die 
piifU j(jb from die user, and include it in the prim job data where 
the server would collect it for accounting purposes. Without GX 
printing, 1 would have to tx^me up with a driver-specirtc 
soluLton. I would have to work out how to patch into, say, the 
LaserWriter H3 driver to get the dialogs to pop up at the start of 
the print job, append my own information to the generated 
PostSeripr, and so on. And my solution would proliably have 


needed to be redtme for UserWriter HA. And it would have to 
work in a completely different way for any other driver, instead 
of going to all this trouble, I did the Macintosh client as a 
QuickDraw GX priming extension. This allowed me to hook 
into the printing pnxrcss in a clean, well-behaved way that 
should work with any applicTition, and any GX printer driver. 

Incidentally, ihe company didn't have Uxj much trouble 
implementing dieir Windtiws client, since Windows supports 
[irint queue processors that can mexlify the output of printer 
drivers in various ways, without requiring you to replace die 
drivers. Old QuickDraw priming is one pan of the MacOS that 
makes Windf>ws ItK^k gtKxf! 

GX printing not only solves existing problem.s, it also 
makes new thing,s po.ssihle ihai are difficult or impo.ssible to 
do any other way. Vor example, I published a proposal for 
atUiching URL tags to GX graphics, i have even released a 
version of Sim pie View, my GX graphics viewer, tliat supports 
clicking on rhese hot links. Now, iliere is no way that 
everylK>dy on the Wef) is going to buy a Mac and install GX 
just to view these graphics, but through the GX printing 
architecture, it would be possible to write custom printer 
drivers that would output these graphics to cross-platform 
forriiaLs such as HTML or Acrobat PDF, translating the IFRL 
links accordingly. You could use a small, purpose-built 
application for attaching these links it> particular graphics, 
then simf>ly paste or tlrug them into existing word-processing 
or other applications that need know nothing about GX, after 
which generating the finah Web ready output is as simple as 
using the "Print” command. This is Web authoring, the 
“component software” way! 

Sure, you could define new Quic'kDraw picture comments 
to try to provide cc|uivalcnl functionalily under the old 
QuickDraw printing architecture. However, even ignoring the 
fact that it is harder to write a QuickDraw printer driver than a 
GX one, you'd still \yc snick with the low c|uality of QuickDraw 
graphics, which is particulariy emb;uTas.sing when youYe trying 
to output to a high-quality format like AcTobat PDF. 

GX printing offers full programmatic control over the 
print job — any option the u.sct can set in the Page Setup and 
Print dialogs can also be directly queried and changed by the 
application. Imagine using this to improve the smartness of 
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InterLok Pro. 


by PACE Anti-Pfracy 

Trialware. Denioware. 1 internet distribytion. 
You know you need iL You know il has 
to be flexible and secure. And you don*t 
want to write any more code, or give a 
percentage of your sales to one of those 
“service bureau” solutions. Sound familiar? 
Then take a look at the interLok Software 
Authorization system. 

InterLok provides “software registration 
insurance”Jetting you turn finished 
applications into locked, time-limited 
"trialware” in minutes -with no additional 
programming! Your software can then 
be distributed via any media {Internet, 
CD-ROM, diskette), used under demon¬ 
stration limits that you define, and 
remotely unlocked with a unique key 
that you issue. 

For the most flexible, secure, and 
powerful software authorization 
system, turn to PACE Anti-Piracy. 


Secure Software Distribution on the Web 



Visit our Web site at: 

vv .paceapxon. 

Vox: 40S-297-7444 
Fax: 408-297-7441 
Tb” TTiTeT E-Mail: sales@paceap.com 


Features 

• No source code modifications required 

• Autumaticaiiy locks data files to run-time 
database solutions 

• Works with alt leading installer tools 

• Demo options indude days of use, specilic 
date, number of launches, unlimited demo, 
and expiring to “nagware” 

• Aulhorizalion options indude serialization, 
machine-unique password, and uncopyable 
key diskettes 

• Customizable text messages for user dialogs 

• Adds registration information capture to 
your application with no coding 

• Available API for use with “non-application” 
components, such as system extensions 

or plug-ins. 

'■ 'k .‘f 

revL:":e5 fr^erL^':! 

Price listed is for InterLok Standard/3000 edition 
annual licence. See PACl: web site for other prices. 

InterLok Standard: Price S499.00 



document formatiing — if the user pastes a very wide graphic 
into a portrait-ofienied dcKument, you could automatically 
reformat just that page in landscape orientation, or using some 
other wide paper type that you know is available. (Perhaps 
first putting up a confirmation dialog to let the user know 
what i.s going on.) Also, think of vertical market applications 
like check printing, which can automatically use their own 
custom paper types with minimal requirement for the user to 
stuff around in print dialogs. 

Apple (and other vendors) may very well try to provide 
features like these in future versions of their old QuickDraw 
printer drivers. However, given that you would have to 
reinvent these features for every driver, what guarantee do 
you have that they will work the same way from one driver to 
another? (.ook at the me.ss of inconsistencies in Lite supjjon of 
existing QuickDraw picture comments between different 
drivers, and imagine that multiplied tenfold. 

One excuse given for canning GX priming has been iLs 
limited acceptance among developers and users. This is 
entirely Apple's fault. Many people were put off installing GX 
printing because it caused incompaiibilitic.s printing with 
.some applications. Most of these incompatibihties came about 
because GX printing broke so many old hacks that were 
needed preei.sely to get around fnistrating limitations in the 
old QuickDraw' printing architecture. 


Rxamplc: GX tireaks the "^space hack''. Old QuickDraw 
j>rinting offers no public API call to ask for a font to be 
downloaded to a PostScript printer so you can make use of it 
in your own PostScript code, which is eml>edded in the 
document. However, there is a way to force this to happen. 
Simply use standard QuickDraw calls to draw a single space 
character, asing that font, somewhere on the page. The dumb 
litserWritcr driver will obligingly load the entire font into the 
printer, and leave it there for you to use. 

GX printing is much smarter than this. It will load only 
the minimum subset of the font necessary to print the 
character, and tt will delete It from the printer's memory 
immediately afterwards! Tfte good news is tliat GX printing is 
.so resource-cfficieii! that it can successfully print complex 
documents on elderly, memory-limited PostScript primers that 
LaserWriter 8 cannot hantlle. The bad news is that trying to 
trick the printer driver into downloading the entire font by 
printing a single character no longer works. 

On the other hand, GX offers a powerful function called 
GXFlaticnFont, that allows you to do the font downloading 
yourself. It will convert any font to a PostScript data stream 
th:tt you can embed in a print job (or do something else 
entirely) giving you control over encoding and subsetting, 
automatically converting TrueType to FastScript — just alxmi 
anything you might want to do. 
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Eureka! At last we can consign the space hack to the 
dustbin of history, where it belongs, right? But there is just one 
problem — GXFlattenFunt is not dfx:umented in any of the OX 
volumes of Inside Macintosh. So, how were developers 
supposed to find out how to use it? 

This is the general problem. GX offers new, better, cleaner 
ways of doing all tiie things that you needed those old hacks for, 
and much more l^esides, but Apple has done a lousy job of 
explaining tliis to developers (and users). The result — people 
were left lo discover GX priming on ilieir own, wilhotiL any clear 
idea of what its benefits were about; then as they hit the 
predictable problems, and little or no help was forthcoming from 
Apple on what to do ahont them, GX was allowed to acxiuire a 
bad reputation, and people gradually gave utp tiy-ing to use it. 

Compare the situation with the transition from MacTCl^ to 
Opcm Transport. In spite of all the hugs and incompatibilities that 
users liad to suffer in that Lransilinn, Apple Ux)k pains Lo keep 
articulating the benefits to both users and developers, wliich 
encouraged them to stick with the new technology, and the end 
result was positive for everybexly. 

Apple’s efforts seems to lx." going largely into Rha[^sody tliese 
days. It's unclear to me how Hhapsexly ptinting will work — it 
kxiks like the whole architecture is going to be PostScript-centric. 
This Lseems to me lo be unwise in ilie current market. PostScript is 
admittedly still dominant in publishing, but its presence is tiny 
(and dwindling) everywhere else. For instance, the vast majority of 
printers lieing sold in the ma.ss market ihese days are inkjets, anti 
very few of tltose speak PcxstScripl. Tliis is ii fact tliat Adt>lx: seems 
quite aware of, even if Apple is not. GX printing would Ixf a way 
to hedge one’s l-jets, since it allows applications to treat PcxstScript 
and ntjn-Po.sLJk.'ripL printers on an absolutely etjual Ixisis. 


Tlie MacOS has always l?een, to me, a foiward-looking 
operating system, pioneering features in areas (device-independent 
graphics and printing, multimedia) which were not traditionally 
Q^nsidcred to be the domain of die operating system, l>ut which 
aimed out to be important in supporting the innovative, new 
applications. This case of dropping an important next-generation 
leclinology, and going [rack to an old one, Ls not the Macintosh Way. 

Sure, Apple has had its share of failures that were 
technologically poor and deserved to fall. Unlike some other 
companies, Apple cannot afford Lo keep tlirowing money at 
mediocre solutions to force them to succeed. But the problems 
that GX printing solves are not going to go away. Apple is 
foolish to scj[uander their resources in this way, [)y throwing 
away such a well-thought-out, painstakingly-built solution, and 
trying to develop another one. 

JMwrrmce D*Olitmw 
Ido^mkato.ac.nz 

Relevan r URLs 

1. Apple Press Release: 

<http://produa.info.apple.eom/pr/press.releases/1997/qZ/970303.pr 
.rel printhtml>. 

2. Freeware Duplex Helper: 
<http://www2.waikato.acnz/ldo/sw/index.html#DuplexHelper>. 

3. Proposal for attaching URL tags to GX graphics; 

<http://www2.waikato.acnz/ido/gx/URLTags.html>. 

4. Sini]:ileView: 

<http://www2.waikato.acnz/ldo/sw/tndex.htm[#SimpleView>. 
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Help Make MacTech Work 


Ho, r at MacTech Mqgazirw, we iv!y lieavily on 
outside writerT^ for most of the material that 
appeals in our pages. If I'eaders did riol 
participate in die magazine, sending us tlieir 
ideas and talcing the time to write articles, there 
would be no MacTech. Mac/eeb Mcig{izirie isS 
nol a siatt cT writers standing a constant stream 
ol' one-way mess^iges ouiwaixls; it's a living, 
evolving network oi Readers conversing wiili 
one anuliCT, educating one another, sharing 
their knowledge, their ex[ieriente, their interest, 
tJieir trials and trihulations and joys and 
successes in die constandy unfolding story of 
prograiiiniing the Macintosh. MacTech 
Mas^azifie doesn't just happen: if.s what the 
community makes it. If we cany reports of 
fumre trends and technologies, if wc teach 


Lrseful uicnlitKls, if we review new 1 looks and 
texis. if we provoke thought. |.irovide liel|), rkle 
die wave of current interesi.s and (^mcems, it is 
only lieonise we relleil the dioughts of our 
readers, who s|ieak tlirough our pages. 

You are invited to involve yourself in 
tills exciting conversation amongst readers. 
No matter who you are, no matter w^hai your 
credentials may lie, if you have a talc to tdl, 
a trick to share, a technique to teach, w'c 
want you to consider joining die family o\ 
those who write for MacTech. 

Don'i jusl wait for a topic to lx* covered 
or a technique esplaineii in MacTech/ Take 
re.s[X)n.sihility! Write us an article yourself! 

To write for MacTech, just .send for our 
Wriiefs Kit. It's a Microsoft Word file 


containing the Styles you need to use, and 
giving lots of helpful advitx* and information, 
induding all the legal stuff. You ran let us 
Imow' wTiat you’re writing about, or, if you 
want to, you can just write tlie article and 
spring it on us when it’s done. iNotcj We 
also have a need for fxxjple willing to make 
themselves available if) write occasional 
prfxkid/lxKik reviews,! If we publish yf)ur 
article, you’ll l>c paid for it! 

Write to us. the ediloria] staff, at 
editorial®mactech.com (or one of the other 
addiesse.s listed on page 2 of tlie magazine). 
Take the future of MacTech Magazine into 
your own hands! 

M- Ihffpiw* 

JVnirmMwn I brrrigfTtT 

Madi^' 

y A 0 A ; I N E 
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Developer Central' 

Sponsored by 

^ Apple 

and 

for Mticintosb 
Frogrammen & Devehp^rs 



MAGAZINE 


Macworld Expo/Boston • August 6-8,1997 
Bayside Expo Center 


If you are developing Inlernel, muUimedia, custom 
applications, or engineering solutions for the Mac® OS, 
Rhapsody and other Apple® platforms, then you need to 
visit Developer Central — your all-in-one source for the 
latest tools for Macintosh development. 

Whether you want to jump-start your knowledge of 


Matrinkxsh development, or t:ome up-tospeed on new L(x>ls 
or technologies, Developer Central will give you tiie inside 
scoop on Macintosli development by putting you in front 
of represeniaiives from Apple Develtiper Relations and 
third-pany tools developers. You’ll even access tlie latest 
naming and developer support programs offered by Apple. 


At Developer Central, vou can... 

• Talk directly to representatives from Apple and third-party vendors 

• Demo developer products and tools 

• Attend sessions in the Developer Central theaters 

• Get the best deals on tools, training, and developer resource materials 



Mac OS 


So, no matter if you’re developing a departmental system, 
using the Macintosh in science, developing plug-ins for the Internet, 
or planning the next great Mac OS application or multimedia title, 
you’ll find what you need at Developer Central. 

Developer Central 

The Source for Macintosh Development 

Sponsored by Apple Computer, Inc. and MacTech Magazine 


Apple, the Ap^lc logo, Macintosh, Mac, and rhe Mac OS logo are registered trade™ rks of Apple Computer, Inc. Devetoper Central, Virtual Dcvdoper Central 
are trademarks of Apple C;omputer, Inc. MacTech is a listened trademark and Developer Depot is a trademark of Xpbin Corporation. 









Ir's Caixi:d MacsBug 

Not MacBiigf not MacBijgs. The acronym stands for 
''Motorc.)Ia advanced computer systems debugger/ Tliis powerful 
system extcosiori iilk>ws developers to view and manipulate the 
contents of the Macintosli ram. You can download tlie latest 
version from Apple’s Developer World ftp site, but if that (or any 
Apple ftp server) is liusy clieck out At>ple’s “Software Home" 
page, 'the Software Home allows you to search for the latest 
version of any software Apple distributes. 

MacsBug on be installed by simply dragging its file into 
your system ft)ldcr (not your control panels folder, not your 
system extensioas folder). When you restart your “Welcome to 
Macintosh" screen will display "debugger insialled" if MatsBug 
loads (or the phrase “...cany a big .stick" if you have a Ix^ta O.S). 
Once installed, you can drop into MacsBug by hitting the 
command and power (triangle) keys together. Older sysKims 
require a system extension called pn>grammers key to drop into 
MacsBug. Dropping into MacsBug nsuspeiids all processes and 
allows you direct access £o all values in memory (great for 
pausing Doom), lb retinn to the finder hit command-G, or to 
restart your Mac type “rs.” 

One way to learn more about u.sing MacsBug is to drop 
into it and type “help" (or if you'd rather get the same 
information vvithoni wandering around your system memory 
visit Thomas Kirnpton’s MacsBug Help page). The Code 
Mechanic, Dave Evans, has at least three develop articles abouf 
wielding MacsBug (my favtjrite was “Stalking the Wild DerecD. 
In the September 199'i MacTedi tips and tidbits there is a nice 
example of how to build a MacsBug macro, and the neat trick 
of making it execute automatically, every time MacsBug is 
entered. Clieck it out on the MacTech website. 

J>leuthing through your systems memory is only half the ftm 
though. When youVe built up enough confidenc:e to try and 
manipulate some memory see the Kch)1 MacsBug Tricks page. 

Dawnload MacsBug from Devworld 

<.itp;/%.apple.copn/devwoiid/TooLC hest/Testi r>g_*_Debugg i ng/Debuggers_’_dcnids/> 

Find the Latest Apple Software at Apple's “Software Home" 

<http://sa pport J nfo. appi e. c oft)/ 11 [ who m p ht m I > 

Download Programmers Key or EvenBotterBusError 

< f [ p: //I T f 3. a f)p!e. a ] r r 3/df^v wor I d/T ool_Chest/Testin g_-_[)ebugging/GeneraLtools/> 
MacsBug Help 

< h tip: //WWW. am b ro si asw.com/-dnebi ng/m acsbug. html> 

Stalking the Wild Defect 

< h ttp: // d cv worl d. apple, co m/dcv/tcchsuppoft/develop/issue2 7/bala nce.htmb 
The MacsBug "Every time" Maao, MacTech Archives 
<http://vwwv.mactech.com/Aiticles/Vol 10/10.09/Sep-94-Tips/text.htm]> 

Koof MacsBug Tricks 

<http://gossa met. wheatonma. edu/users/bcoteAy^gy ml t/Macsbug. h tm l> 


EvenBettekBusError — The Art of the 
Controlled Crash 

EvenBetterBusError crashes your Mac. Unlike most software 
though, Greg Marriott’s system extension does so on purp{jsa 
When you have FBBE installed, if your t:c)de dereferences a NIL 
pointer, writes to a NIL pointer, or attempts to execute code at 
NIL EBBE will crash your Mac (dropping you into MacsBug). 
Greg has put EBBE and three other stress testing Uk)Is that lie 
developed at Apple on the wef^. Greg warns that sc^nie tlicse 
tools arc showing a litde age, and recommends folks consider 
Onyx technologies commercial stfes.s testing kK>ls. Onyx’s QC is 
an established and well res per.ted stress tester If you want to 
shake your ctxle — hard: give it to QC. 

Oh, and those of you looking for the fourth generation 
of Mr. BusError can find YetEvenBetterBusError (aka 
DavesBeiterBusError) beta on Dave Evan’.s web site. This 
more aggressive version of EBBE, announced in the May 1997 
MacTech, can also be found on the MacTech ftp site along 
with the Tidy Heap C+l class iil)rary (for tracking proper use 
of new and delete). 

EvenBetlerBusError & Other Kool Tools by Greg Marriott 
<http ;//vwvw.spses.com/greg/tools. htm l> 

About 0 C». 

<h ttp://vwvw,onyX'ted), com/f aq/curre nt_QC_faq. htm [> 

Dave Evans & DavesBetterBusError 
<h ttp: //ng .netgate. neiZ-Ii Ide/mechan ic/> 

YEBBE & Tidy Heap 

<ftp://ftp. madech. com/Zm adech/src/13.05/> 

Parting Shots 

Next month Macl’ech Online is going to get serious about 
Java — really. One last debugging tool you should cheek out 
before tlien is the Zone Ranger. Zone Ranger is a valuable 
tool for the counts and total sizes of the free blocks, pointers, 
handles, locked handles, purgeable handles, and resource 
handles that can be found on the Metrowerks web site. See 
you next month. 

— nick.c <m£iiko:(miinc@mactccbxom> 

Joshua Golub's Zone Ranger 

< http .7/WWW. metrowerks. co m/tools/software/zonera nger h tm I > H 


Visit MacTech® Magazine’s Web site! 

http://www.mactech.com 
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If you want to be in the know, then you 
need every article published in the first 
12 years of MacTech* Magazine and 
Apple’s develop™ issues 1-29! 



... in THINK Reference format! 


So hurry, pick up the phone, fire up 
the e-mail, launch that fax machine, 
or simply drop by our web site and 
order yourself this new release of 
the MacTech* CD-ROM. 


Almost 1600 articles from all 139 issues of 
MacTech Magazine (1984-1996) 

Includes Apple develop issues 1 *29 

Improved hypertext, improved indices, and a new THINK 
Reference Viewer — for liglitning quick access! 


New hyperluiks between articles 

100+ MB of source code — use them in your applications, with no royalties! 

Full version of THINK Reference — the original online guide to Inside 
Macintosh, Vols. I-VI 

80MB of FrameWorks/SFA arcliives and the most complete set of FrameWorks 
archives known 


Sprocket™! MacTech's tiny framework that compiles quickly and supports 
System 7.5 features 

The best threads from the Mac programmer newsgroups plus thousands 
of notes, tips, snippets, and gotclias 


Popular tools that Mac programmers use to increase their productivity and 
much more! 



Web Site: http//www.devdepot.com • E-mail: orders@devdepot.com 
Phone: 800-MACDKV-l • Outside tlic U.S. & Canjidi: 805-494-9797 • Fax: 805494-9798 


WlacTech is a regisleted trademark of Xplain Corporation. MacDev-1, THINK Reference, Developer Depot. Sprocket. JavaTech. WebTech, BeTech, and the MacTuforMan 
are trademarks of Xplain Corporation. Other trademarks and copyrights appearing In this printing or software remain the property of their respective holders. 







TIPS & 
TIDBITS 


Steve Sisak 



Protect Against Dereferencing nil 


Dereferencing nil is probably the most common cause of 
crashes, bus errors, type 11 errors and suchlike. It's very easy to 
write code like this: 

char ‘myPtr « GetNewCharPtr (256) j //allocate » 2554iyte string 

If put wmcihing into yuuf char 

fltrepy(rayPtr* ‘•This is a string"): 

// oops! What happens of the caU to GctNewCharPiiO teturacd 
// nil? Your program dies at strcpyl Or-wctfsc-dics 50 lines iaiarf 


Most of these enors can be avoided by checking pointers 
before using them. The following handy routine is something you 
can us at the beginning of every function ro make sure that the 
pointer paiameters passed to the routine are non-nil: 

r - 

Utis handy routine allows you to check several pointer paiams ml 
with one call. The first paiameicr to this routim: niiisi be ihc number 
of params you want lo cfaedL.The refnaining params ate the patams to 
chccJc as Eitany as you like. 

-V 

void ChockRllFata]ii$ (long numPar^nifi, * ^} 
t 

va_list argList; 
void ’next: 
long i; 

// walk through cadi param, up lo numParams 
va_fitatt (aegLlst, numParajas): 
for (1 = 1; i <= numParaiDB: i++) 

I 

// get the neat pnam 

next - va_ar|CargList. void *); 

// assert if the param is nul jf you are using C++, you could 
// throw an exception here, or do whatcvei you like.Thc value of t 
// in this bop will tdl you whkh panun was nil 
assert(next 1“ nil); 

1 

// we're done with our paiam list 
va_end(argList); 


Here's how you can use it: 

//This fimetion has several pointer params passed to it 
void PointerFunc( char *cptrl, void 'anotherPtr, 
WlndowPtr *wptc, Int notAPtr) 

( 

// cheek each paiam to make sure its not nil If any of tlie above 
// paiams arc the program will assert 
Ch€ckNilParains(3 , cptrl, anotharPtr. vptr): 

// now you can safely dcrefeieticc the pomter paran;^! 


Since this adds a fair amount of overhead to your code, you'll 
usually want to use it only in the debug version of your program. 
It will save you a lot of time in MacsBugl 


Automatically Generating an Owner Resource 

When I was working on my applic-ation, I wanted to generate 
different owner resources depending on some liuild defmitioas. I 
wanted to do this using the rez compiler included with 
CkxleWarrior You could also do this williin ResEdit or Resorcerer, 
but 1 like automatic generation far Ixittcr, Especially if you need to 
do builds quite often. 

Normally your owner resource ts of resource type 'the 
signature’, but there is no special definition in one of the .r 
files located in the interfaces folder. OK, you can use the 'data' 
type, but then you need to do some serious ascit- 
>hexadecimal conversion. 

What 1 did was the following: create a new type of resource 
which only contains a pascal string. Of course the type must be 
the same as your signature (also known as the creator) code. 

For example, when your application uses '????' as its 
signature (don't forget to register your signature along with the 
fifetypes you use by visiting Apple’s website at 
<htlp://gemma.3pple.com/dev/cftype>), you can use the following 
in your own .r file: 

type * ? ? ? ? ' 

( 

petting: 

h 

resource *????' (0, “Owner Resource") 

( 

lifdef BUILD.DEMO 

'AppEication Demo 0 1997 TIm: Software Publishers. Inc' 
f else 

‘Applicatkm © 1997Thc Software Publisher. Die" 

#vndlf 

h 

Note that it is customaiy to use resource id 0 for your owner 
resource. Of course you can alst) define other resource types if 
you need tliem for your own data structures you story in the 
resource fork. You can see some useful examples in The 
SysTypcs.r and Types.r files. It sure beats entering some 
liexadecimal codes in your text editor! 

If you still want to use ResEdit or anotlier editor, you can also 
ctmsider writing your own restiurce templates. See chapter 7 in 
the book "ResEdit Reference, For ResEdit version 2.F with ISBN 
Ck20H57767-4 for writing your own resource templates. 

Frank Manshande 
fnmkm^and.n! 


Vinay Prabhukar 
Cray Owl Software 
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(...and we really mean now.) 


Think of it as your source of news and announcements in the 
MacOS developer community. Loaded with up to the latest news, 
and constantly updated with developments in our industry. 

MaeTech* NOW brings you up to sp>eed on everything you need to 
know — instantly! And thanks to our new “fast-download” design, 
you’ll get to the information you want in seconds. 

Give it a spin! Check it out today and get access to over 1500 pages 
loaded with news, tips, programming secrets, product reviews, and 
much more. And for those of you looking for some kicks, there's the 
ever popular “Programmer’s Challenge” section where you'll get to 
bang heads with the best in the community. 

Log on to MacTcch NOW. Things arc happening right now, and you 
should be aware of them. 



MacTecti is a registered trademark of Xpiain Corporation. MacOev-l, THINK Reference, Developer Depot, Sprocket, 
JavaTech, Weblech, BeTech, and the MacTutorMan are trademarks of Xpiain Corporation. Other trademarks and copy¬ 
rights appearing in this printing or software remain me property of their respective holders. 





MEWSBITS 


by Jessica Courtney 



InterLok Pro - a Powerful New Toolset for Creating 
Trialwarf ani> Locked Appijcations 

Next-Generation System from PACE Anti-Piracy Provides 
""Registration Insurance” for Internet Distrtbutk>n of Software 

PACE An Li-Piracy, the leading developer of software 
audioj-Liation and protection systems for MacOS, is now sMppiiig 
InterLok Professional Version, the cxjmprehensive toolset for the 
creation and remote unlcxking of trialwre anci pK>tecred software. 
InterLok Pro coinpicles ilie transition of PACE’s products to tlic 
conipan/s fourth-generation technology, and joins interLok i^mndaid 
Version, the one-step aimkey’ trialware creation toolkit tntrodiiced in 
January of UiLs yc*ar. The two prtxJucts are fully leclinology- 
compatible, and all features of InterLok Standard Veisitxi are 
supported in InterLok Fro, along with an impressive list of more 
sophisiicaicd capai)iliiies, making InterLok Pro a complete software 
autliorization, protection, and anti-piracy solution. 

InterLok Usnge Scenarios 

• Trialware: Witli a single click, a developer applies Interlok’s 
“trialware envelope" to an application, and can imniedialcly jxxst 
the prvxliicf on the Intemec Pn>six^ctive buyers download tlie 
package and can evaluate it for the amount of time or number 
of launches die developer has sfxxified. When die product is 
purchased, the developer uses lnterLt>k to prtjvide a key dial 
removes the demonstr:ation limitations and optionally kreks the 
prcxiuct to a specific machine. 

• Web site integration: A developer uses InterLok to incorporate a 
registration dialog with a bimon that, when clicked, launches the 
cuslomePs web browser and takes them tfj die developer's web 
site to complete an electronic purcliase and/or registration. Once 
complete, other tools in the InterLok package c^in l:>e used to 
integrate InterLok components witli web pages that can 
automatically dLSjx.^nsc unlocking key.s to autlioriix-d customers. 

• Remote Feature Control: A product with various sets of features 
or rtKxlules can l)e configured with Interljok to allow those 
features to be stdd scfiaratcly and ncmolely enabled or disabled. 
Using InterLok Pro’s encryjXed, key-controlled tciken storage 
mcx.'hanism, a customer can be issued a simple key dun will 
activate newly-purchased cximponenLs in the software they have 
already iastalled and are using. 

• Database Ltxking: Rescrarchers who spend coasiderable time 
and money preparing a database containing specialized or 
proprietary infomiation can encrypt and bind the datalxi.se to a 
specifit: copy of the database engine. This allows database 
distril^udon to lx* cximpletcly cx>ntrt)lled, and prevents anyone 
with jiist a standard copy of the database “runtime" .system frcxii 
accessing and using the data. 


Advantages of the IiiterLok System 

'I he InterLok system offers the highest level of .security 
for the authorization and protection of .software products, 
while also providing the most user-friendly system. Because 
the security mechanisms are software-based, users of 
InterUik-secured software don't have to wrestle with 
hardware keys or “donglus”; a developer can achieve the 
same ‘‘hardware-protected” type of security by means of an 
InterLok “key di.sk:ette" that is easy for users to understand 
and use. InterLok inconiof^te.s unique characteristics of the 
user's system in the creation of an “electronic fingerprint” that 
can be utilized as the software lockpoint. And Ix^cause 
software developers have different re(]Uirements for the 
authorizaiion and protection of their products, PACE has 
designed the InterLok system to cover a broad spectrum of 
capabilities and options. 

Using the InterLok system, a developer can configure a 
.software package to be unlocked with a serial number, a 
machine-unique “challenge-response" password, a key 
diskette, or any combination of these. Demonstration versions 
can be created from full-fealured applications, with the 
demonstration limited by time, number of program launches, 
and/or the disabling of selected features. At the end of the 
demoastraiion cycle, InterLok can be configured to prevent 
the application from running and display a developer-defined 
message, or to transition the application to “nagware” that 
reminds the user ihai the software needs to he authorized. 
When the customer is ready to purchase, the demo version 
can be authorized remotely with a software key. In addition, 
selected features can be unlocked using different keys, so 
Uiat a developer can sell progressive feaiure enhancements as 
the Li.ser requires them without requiring the installation of 
new software. 

The InterLok system also cTeates new tjpportunities for 
participants in electronic software distribution (E5D) 
channels. Becau.se InterLok can create full-featured, time- 
limited demos that can he remotely unlocked, and can apply 
these locking features to finished applications in a turnkey 
fashion (Le. without programming), it enables secure 
electronic software delivery at any level within the 
distribution chain. In this way, a software developer can give 
a distribution partner more latitude in the promotion and 
delivery of software products. 

<http://www.paceap.com>. 
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Seapine Ships TestTrack 1.5 for Maclntosh 

TcjitTrack 1.5 Delivers Cross-Platform Bug Tracking to 
Macintosh Developers 

TestTrack 1,5 is a fuJlTeaturcd hug Imcking solution at an 
alTorckible price. 'lestlrack 1.5 adds versions for Windows 95 
and Windows NT TO. TestTrack offers complete feature parky 
and a virtually identical user interface across platform 
versions, so users can work on their platform of choice and 
retain full database compatibiliry between Windows and 
Macintosh systems. 

'lestTrack 1.5 is a bug tracking tool combining full 
functionality and a user interface into an affordable package. 
With cross-p kit form support, developers nf} kvnger have to roll 
their own database to share fjugs between Macintosh and 
Windows development teams. And, TestTrack sets a new 
standard for ease of use among bug tracking products. 
TestTrack users can l)egin tracking l)ugs immediately after 
running the simple installation program. Multi-user and cross- 
platform setup is a breeze a.s w'elL The benefits of a bug 
tracking program cannot l)e fully realimJ until everyone who 
needs acce.ss has access. 

Solo Bug - Simplified Technical Support 

A new addition to TestTrack 1.5 is Solo Bug, a stand-alone 
bug reporting program 'lest'lTack users can distribute freely to 
their customers and tx^ta sites to automate repotting bugs and 
recjuesting features. A Solo Bug file ccintains a eusujmer‘s hug 
report, machine configuration, contact information, even a 
binary file atLichmem. Sea pine Software is working with tither 
companies to create add-ons lV)r 4tli Dimension, Visual Basic, 
Visual and ActiveX-enabled developincni environments to 
enable developers to drop Solo Bug bug reporting fiinctionality 
into their applications. 

New Features for Version 1,0 Users 

Also new in version 1.5 is an import command that makes 
it easy to transfer existing bug databases from FileMaker Fro, 
Microsoft Access, 4th Dimension, and other custom databases 
inkj TestTrack. An equivalent export command simplifies 
exporting TestTrack data for further analysis and reporting. 
Te.stTrack now tracks more bug-related fields than ever and 
adds .support for binary file attachments. A new workiwok 
feature lielps developers track other projea-related tasks al<mg 
with their assigned bugs and feature requests. A handy release 
notes command consolidates all of the release notesi from a 
specific product version and generates a text file that can be 
included with a product release. 

Managing duplicate bugs on medium to large projects is 
always a hassle. Duplicate bugs make it difficult to determine 
the true project status and skew the quality control statistics. 
A feature unique to TestTrack is the ability to consolidate 
multiple reports of a bug or requests for a feature into a single 
bug report. The information specific to the eastomer's bug 
report remains available as a sub-record of the main bug. 


Since le.sFlVack tracks how many times a specific bug has 
been reported or a feature requested, this information is 
available for prioritizing your work. 

<http://www,seapine.com>. 


ViRTUAI LY UNIJMITED FREES GAMES DEVELOPERS FROM PC- 

Oni.y/PC-Ftrst Focus 

3D Game Machine offers outstanding real-time 3D and 
simultaneous cross-platform development. 

Providing game and multimedia developers with 
advanced 3D technology, Virtually Unlimited has released 
version 2.0 of its award-winning 3D Game Machine 
framework for MacOS and Windows 95/NT. 3i> Game 
Machine (3DriM) is a specialized game development tool, 
featuring a highly optimized core with a straightforward 
C/C++ API, as well as visual tools. Full integration with 3D 
graphic: applic’ations is provided through its 3DGM Factory 
interactive modeler. This technology delivers impre.ssive 
software rendering, while direct 3Dfx Voodoo support 
enables maximum quality. 

3DGM allows projects ranging frcjm flight simulators to 
motor racing games and educational titles to l)e built with 
high image quality. I'his power and flexibility is the result 
of proprietary technologies developed for true-color 
software rendering, large dynamic world management and 
SolidReality polygon-precise collision detection. Creative 
development teams are taking advantage of the freedom 
offered by 3D Game Machine to build original titles without 
the limitations of game-specific engines, and, most of all, 
without the risks and uncertainties involved in developing 
ihcir own .3D technology, 

3D Game Machine is 10()% OS-independent, so client code 
is absolutely identical for MacOS and Windows 95/NT, even 
little-big endian issues are rnmsparenfly handled. 3DGM Ls 
optimized for both PowerPC and 68k procc.ssors and runs on 
any color Macintosh, as well as Windows 95/NT systems. 

3I)GM is compatible with Apple's GameSprockets and its 
layered architecture allows custom implementation of 3D 
hardware acceleration interfaces such as QuickDraw3D RAVE, 
The 3DGM Factory interactive modeler imports files in the 
standard Quickdraw 3D Metafile format (3DMF), as well as 
3D Studio and DXF. 

<http://vvww.virtual!y3d,CDm>. 
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The Law Office of Bradley M. Sniderman 

California Lawyer focusing on Inteilectual 
Property, Corporate, Commercial and Contract 
law, as well as Wills and Trusts. 

If you are looking to protect your software with 
Copyright or Trademark protection, or if you need 
help establishing or maintaining your business, 
please give me a call or an e-mail. Reasonable fees. 

(310) 553-4054 
Brad@Snidermaii.com 


MacTech^ Magazine is your 
recruitment vehicle 

When you need to fill important positions at your 
company, MacTech* Magazine is the consistent choice of 
companies across the country for liiring the best qualified 
Macintosh programmers and developers. Let MacTech* 
Magazine deliver your recruit-ment message to an audience 
of over 27,000 qualified computer professionals. 

Call Ruth Subrin at 
805/494-9797 


^Oyr Server is toaded " 

-MftXpcrU 
Prftgriminvr 

rivti iboal 

tht iicl 

toys anywhwr t. 

Programmers, Analysts, 
& Adventurers Wanted 

Madcperu has openings for 
Macintosh & Oracle programmers 
with C, C++, PL/SQL, Java, and 
Corba ExperiefKe,. .and cross-plartform 
integration itperts, to bool. 
Taka lh> first st*p to pdvsfituF*. 
Call MkhppI Ruttla ab 

if fai/| 04 - 3 St-lS 47 
UppUUik: vptiif Aai: Hjclpim 
fct I p ://wirw, wa cipsrt s kpi rti 

Ipttriitt: xptrtiiliiHfi.iitt H 



HARDWARE 


PartStock, Inc. 

612 . 378.3996 
Mac Parts & Systems* 

3 years old and growing. 
Because of a restock fee for returned 
parts is appfieef to most returns we 
request thaf you have a spedfic part 
number when you caJI. Part nuir^jofs 
accepted are the IBM FRU, Compaq 
Spares and Apple Service Pari Number. 

Calf Mike Regan 
Visa & Master, School & Govrrt 
big Co. PO is accepted. 

•All systems are refurbished. 

1621 E Hennepin Ave 
Minneapolis, MN 55414 
mregan62l QdaoLcom 
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Professional software developers 

looking for career opportunities 
should check out our web site. We 
offer nationwide employment assis¬ 
tance, resume help, marketability 
assessment, and never a fee to the 
applicant. 800-231-5920, Fax 800- 
757-9003 eMail:das@scientific.com 


Scientific 
Placement, Inc. 




ithattiieiiiietwoim 

The Trattnei Network, 
"The Digital Talent Source", 


is looking for experienced Macintosh developers for cutting edge 
opportunities in NoTthem California and Nationwide. 

TBI is plugged into projects in UI, Internet, Multimedia, 

Cross platform, and "The newest and hottest developments"’ 

Visit our web site at: www.tratnet.com and see what 
openings are available for: 

JAVA/lnternet Stars ■ Software Developers 
QA/QC Professionals ■ Project Cooniinator/Hanager 
Multimedia Developers ■ Network Professionals 

The Trattner Network has a unique history in Mac consulting coupled 
with exposure to emerging technologies. If you are looking for a chance 
to enhance your skills and marketability, please email or fax resume to: 

The Trattner Network ■ Attn: Debbie Stevens 
170 State St., Suite 240 ■ Los Altos, CA 94022 
Phone (415) 949-9555 ext, 115 ■ Fax (415) 949-1026 
email; dstevens@tTatnet.com 
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Advis 

Advanced Information solutions 

OpenStep Today-Yellow Box Tomorrow 

AdvLS is an original NeXT Object ctiaimel panner speciatizing in 
distributed object applicaiion development We have grown rapidly 
by helping Fomine 500 companies use advanced technology to gain 
competitive advantage in their markets. 

Join our team now and get involved with the object approach to 
application developmeni as we continue our growth and success with 
the new Yellow Box plaifonns. Visit our web site at www.advis.com 
or meet us at Mac World/Boston to learn more about our current 
openings for: 

* StafT and Project Managers • Project and Solutioii I^eadars 

* St, and Staff Developers - Application and Solution Ardiitects 

Advis, a Ibuf’-year-old privately held company, provides 
application development and client consulting services to a large 
high-proBle client base utilizing distributed object technology. 
Headquartered in Boston, MA, Advis also retains southeast and 
west coast regional offices. 

Advis 

Aun: Kimberty Mack 

268 Summer Street, 7* Floor Boston, MA 02210 
PhoiK: (617) 574-7113 Fax: (617) 350-7696 
kjiiaek@advis.com www.advis.com 

Oppwtunitv Employfr 



PERCEPTIVE SCIENTIFIC 
INSTRUMENTS, INC. 


Macintosh Developers for US & UK 

Perceptive Scientific Instruments, Inc. is a global 
leader in the development and marketing of digital 
imaging systems for genetics applications. The 
company has offices in the United States and the 
United Kingdom. 

We arc currently looking for Macintosh Software 
Developers for both our US and UK locations to work 
on our next generation products for the genetics 
market place. Candidates should have 2-5 years of 
Macintosh programming experience in C/C++ with 
strong analytical skills. Experience with object 
oriented programming methodologies will be a plus. 

Please send your resume to H, Baxi, PSIl, 2525 S, 
Shore Blvd., League City TX 77573, USA or fax to 
+1 (281) 538^2222 or email to hhaxi@persci.com. 



The fastest, cost effective way to get product off your shelves* 

For information: • Voice: 805/494-9797 • Fox: 805/494-9798 • E-mail: vendor_,relattons@devdepot.com 
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Calling CFM Code From Classic 68K Code 

or There and Back Again, A Mixed Mode Magic Adventure 


There are sfiedj'u: instances wheti yon mitst 
call Code Fmgtnenl Manager (CFM) code 
from classic (^K code — for example, f 
your application cannot he coniH^rted to 
CFM, hut you imnt to he able to use CFM 
lihraries. Or, you want io add plug-in 
sup/x}rt to an existing classic CySK 
apf)tication without having to convert it to 
CFMt^'K. In addition ytm rmy imnl to use 
CFM6dK to iiet^lop an application to nut on 
Ix^lh 6HK and PoiierPC computers ami use 
a single fat library for both environmenls. 
Another instance uHjuld he developing 
for OptmDoc, which requires shared 
lihmry support. Prior to this article, only 
CFM appikatiorLs could lake cuivaniage of 
OlKmFkK:. ^(his article explains hotv to add 
libraty^ sup[H)rt io classic code. 

Cai^ung CFM From Classic Codl 

The iKusic steps for cilUng CFM from 
classic ccxlc arc as follows: 

]. Determine the address of the CFM 
routines you warn to call 

2. Create a routine descriptor for 
the CFM routine. 

3. Call the routine descTiptor, 

4. Clean-up after y^Hirselft 

Dftlrmjntng tiie Address 
OF THE CFM RoirriNES 
The most conution way to <letermine 
the address of a CFM routine Ls to use 
FindSymbol against a shared libraryc 

OSErr FintlSymboi tConnectionlD eonnID, 
SLrlbS 

Ptr* symAddr* SymClaffs J i 


is the name of die synilH>L in this rase the name of liie naitine we 
w^ant to call. The addtess of tlie symlxil is returned in the third 
[xiramc'ter and the best piirameter returns the symlxils class. 

Creating a Routine Descriptor 

In CFM tXKie, you nortnally use the Newlit)ULineDescripn>r 
routine to create routine ciestTiptors. I tie non-Cl*M version of tliis 
Ls the NewKoutineDescrifitor1raf}() nnitine. See the notes on 
using NewiFatlKoutineDescriptoiiTrap] at Uie end of this article. 

pascal UniverSalProcPtr RewEDUtinaDRRrrlpiorTrapC 
ProcFtr theProc, 

ProcInfoType theProcInfo, 

ISAType theTSA): 

To create a routine destxiptor, you need the address, the 
procedure informalion and the arcluteeture of the routine being 
de.serilx^d I’he address was obtained in die first step. The 
procedure information is based on the catling conventions for the 
parameters passed to and returned IVom the routine. 4tie last 
parameter is the architecture of the routine Ixang called. In the 
headers, this is defined as the ISA'lype, which is a combination 
of two se[)arate 4 l>il values, the Instruetion Set Architecture 
(ISA) and Runtime Ardiitecture (RTA). 

Determining thf Prchtdorf Information 
The Mixed Mode Manager supports many calling 
cf>fiventions. The most conunon are stack based for Pascal and 
C, register bas<.:tl for operating system traps and register 
dispatched for selector ba.sed Too1Ik)x maps. The etistest way to 
tieftne the pixK'edure infonnation is via a enuni: for example, if 
your rouline was lieftned like this; 

pascal Ptr Get_Messaee(short pResiD, short pindex); 

its procedure intormation would then be defined like this: 

enuni [ 

kGet RefisagePrucfiiro " kPascalStackbssed 
I HKSIILT^STZE (ST7.E^C0I>R (aizeof (i*t r))) 

1 STACK._ROUTlNK_t*ARAHETKRll, SlZE^CODE(sizeof (short))) 

I STACX_R0aTlKE„PARAMLTER(2. SIZE^CODEfsi^eof (short))) 

1; 


Tlie first ixuametcT is a connection ID to 
a fnigment. Ihis c'an be obtained from a call 
to GetSharedLibrary, Get Disk Fragment or 
GetMemoryFragment. The sect>nd parameter 


Note: 'I'he RF:SULT^SIZE, SIZE_COr>E & 

STACK_HO!rnNT._PARAMETFH macros are defined in 
MixedMixle,lL Procinfo is documented in Chapter Two, Inside 
Macintosh: PowerPC System Software. 
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Determining the Architecture 

Everyone seems to be tempted to use GetCurrentArchitecture 
here; JLfST SAY NO! GetCurrentArchitecture is a macro that returns 
the areliitcaure of the currently compilin^^ code, in our case, 
classic. What we want is the arc hi Lecture of t!ie CFM code that we 
are calling from our classic code. Remember: ihe architecture 
includes the ISA and tlie RIA. 'llie correct thing lo do is to call 
Gestalt to find out what kind of CPU die code is running on (68K 
or FPC) and ase diLs to create the routine descriptor with the 
correct architecture: 

static pascal OSErr GetSystemArchitecture(OSType *archType) 

// s(3tlc SO we only GesUit once 
static long sSysArchitecture - 0: 

OSErr tOSErr “ cioEm 

// as'^uEiie wild aichiieciitic 
’archType - kAnyCEragArcb: 

//1/ wc don’t know the syMcm arvhiicLtuie yei.., 

//Ask Gcsiah what kind of machine we an: rujining un. 
if (sSysArchltacLuce ^ 0) 
tOSErr = Gestalt (gtJBtaltEyEArchitecture, 

SisSysArchitecture); 

if (tOSErr ^ noErr) //If no errors 

I 

if (sSysArcbitcciiiire “ gestalt68k) //68k? 

*arciiType = kRt)ti>rola68KArch; 
else if (sSysArcMteciure ^ gestaltPowerPC) //PPO 
•archType = kPowerPCArcb: 
else 

tOSErr = geEtaltUnknovmErri 
// who knows what might be next? 

) 

return tOSErr: 

I 

Note: Don't confuse die OSType ardiitL*clure used to specify 
fragment archiiecture with die SlntH ISA/'RTA archiEectiire u-secl to 
specify routine descriptors. This routine determines the OSTy|x.‘ 
architecture. I did it this way because I use it lo open the 
connection to my shared library» wliich requires the QSl'ype. 
When I create my rtHJline descriptors, I use this value to 
condilionaliy execute the New Routine DeschptorTrap routine with 
the correct ISA/Ul'A typt" pam meter: 

static OSType eArchTypo ^ kAnyCFragArch: 

ISAType tISAType: 

If (sArchType —^ kAnyCF rag Arch) //if aa'hiTrctuff issiill nndcllncd... 

[ 

// A determine currifiit aichircLturc. 
aOSKir = GotSyateirArrhl rectiiret&jsArchType); 
if (sOBErr !“ noErrJ 
return sOSErr: 

( 

if (sArchType — kMotorola6BKArch) //...for CFMfiWK 
tTSAType = kR68kJSA | kCFMhSkRTA: 
elnc if (aArcHTypa ^ kPowerPCArch) //,..for PPG tTM 
tISAType - kPowerPCISA 1 kPowerPCRTA: 
else 

sOSErc - gestaltUiiknowriEr r; //who knows whai might Ik ncxi? 
if (eOSErr = noErr) 

tnytJPP * NevrEoutlneCl'escrlptorTrap t (ProcPl r) ^ pSymAddr, 
pProcInfo, tISAType): 
rot urn ? 30 SErr: 


Calung the Routine Descriptor 
From CFM code you normally use CallUniversalProc to c’all the 
routine associated with a Riiitinc descTiptor. (A Universal Procedure 
Pointer (UI^P) Ls a jitiintcr to a routine descriptor.) However, 
CallUniversalProc is only implemented in shared libraries. For 
comjiatabality reasons, in c:ks.sic cixlc UPP's can lie treated like 
ProePtr’s, i.e,, they aie pointers to executable code. 'iliLs Is because 
the fiTst two bytes of a routine descriptor is the 68K mixed mode 
magic ATrap. When we [ump here frtjm 68K code, die trap is 
executed and the Mixed MtxJc Manager takes over, setting up passed 
fyarameicis in registers or on the stack, based on the Pn>dnfo in the 
routine descriptor: switching die archilcctuio and tlien jumping to the 
CFM code. TTiis is how' you would call your routine; 

// dcfirM: FrocPir of our l^pc 

typ^def pascal Ptr (*Get_MeEsage_ProcPtt) (shoirt pResID, 
short plndex): 

// call It. 

my?i£ - ((Get_Hessage_ProcPtr)mytJPP} (128.3) : 

Cleaning Up After Yoursfif 
DisposeRoutineDescriptorTrap is used lo rclciLse the memory 
allocated for mutine descriptors by ifie NewRoutineDesaiptorl'rap, 

SfiORTCLTTSt Detours & DEAD-ENm 
You may lie tempted to use the macro 
BUtLD_KOLri'lNF_DFSCRlF*TOH, m> tliat you can lutild your routine 
descriptors staticly. Unionunately, tills maaxi expands to include liie 
mat:rt> GetCurrentArGhiteclure whose problem was dcscrilx:d in the 
scctitm alxive. Another problem with diis ajjpixxich Ls tliat the 
Prcx'Ptr passed to die macro Ls exfx.-cted to Ix" a constant at cximpile- 
time. One soJulion lo lx>lii of these problems Ls to txiild your n>uline 
dcscrifJlors in your (^FM library and expon ihem. This way the 
GetCurrentArchitecture nuicno netums the corred aaiiitecture for tiie 
library and tfie PukPU' Is a compite-lime constant. And sintx: die.se 
itniline des^Tiplon; are .suiticiy alUxated ai compile lime, you don't 
have to worry almut disixysing them: their uicniory is leleased wdien 
the library' Is iinkxjtied. Unfortunately, this only works if you have 
source to the library you want to connect lo. 

Using BUILl>_ROLrnNE_DESCRIPTOH to dynamically 
initialise a routine desc riptor Ls not a gtxKl idea. From the cbcssic 
68K perspeclivc, die rtjuiine descriptor is Cfxle being assembled 
out of data. Tliis can cau.se problems due lo tlie split caches on 
68040 CPUs and some 68K emulalor optiiiiixations on PowerPCs. 
You're trying to execute data but instead are executing old values 
from tlie instruction cache. Using New'HoulinelX^scripiorTrap 
insures that the mstruaion cache is flu,shed Ibr the executable 
mnge of the routine dcsc:ripLor - two bytes. 

In order to make die connection lietween classic t'ode and die 
CFM code as transparent as possible, 1 like to put all my CFM glue 
ccxle in its owm sepamte die and use die SiUiie API in it as definetl 
lor my library (asually i>y using the lliirary’s header die). Fat:h entry 
point into tlie library' has its own glue routine that declares a static 
IJPP variable initializeil to kUnresolved4Syni[K)lAddress. By 
checking for this initial value, tlie Riutine knows w'hen it needs to 
l(.x>k up its addR'ss in the library and emm a rouiined descTi[>ior. 
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Here's the glue code for ilie lif^njry: 


Source Code for CFM Library Glue 

#1 ncl lid p. <CodeFrugmerit s * h> 
fliricltide “DemoLib-h” 

// Priv3[c fuiKiion pruiotypcii 

static OSErc Fiiid_SytHbol CPtr“ pSyniAddr, 

Str2S5 pSytnNamc, 

Proc-TnfoType pFroclnfoJ: 

static pascal OSErr GetSystamArchitectiiretOSType 'archTypeJ; 

// Private fijnctionii 

static.' pascal OSBtr GetSyatamArchiractura{OSType 'archTypeJ 

I 

static long sSysArcbitecture ” Oj //static so wc only Gcsiall once, 
OSErr tOSEtr = noErr: 

*archType " kAnyCFragArch; //assume wiki aidiiteetuit 
// If we don't know the system arvJiiieeitire yet... 
if (sSysArchitecture ^ 0) 

// *..Asli Gesiaji what kind of machine we are running ort. 
tOSErr = Gestalt (gegtaltSyMrchi tectnre, 

&sSys Architect lire): 

if (tOSErr = noErr) //if no errors 

I 

if {^SysArchitecture = gestalt68k) //68k? 

•archType “ kHotorolaftSKClragArch^ 
else If (fiSysArchitecture ” gestaltPoverPC) //PPC? 

'arefaType * kPowerPCCFragAreh; 
else 

tOSErr gestal tllnknuwnKrt i // who knows wiiat iiiiglit be next? 

1 

return tOSKrr; 
i 

static OSErr Find_Syffibcil(Ptr * pSymAddr, 

Str255 pSymNsEne, 

ProcInfoType pPrcjcfiifo) 

1 

static ConnectionlO sClD “ 0; 

staric OSType liArckType ^ kAnyCFragA^^^h; 

alalie OSErr aOSErr ^ noErr: 

StrZbi errMessage; 

Ptr mainAddr; 

SytnClass symClass: 

TBAType tTRAType: 

If (sArehTypo ™ kAnyCFtagArch) //if aitMectiiit is unikPinixl..* 

I 

sClU “ 0: //...foac (rcX'tmnctt to library 

sOSKrr = CetSystemArchitectnrefknArehTypeJ: //ikurminc aaiiiteciure 
if (sOSErr noErr) 

return sOSErr: //(K)PS! 

J 

If (sArebTypo = kHotorola6SKArch} //CFM6HK 
LTSAType = ldi6«kISA | kCFM68kRTA; 

Lvlae if (BArchType “ kPowerPCArch) //.,.h>rPK:CFM 
tlSAType - kPoverPClSA | kPowerPCRTA; 
else 

sOSEr r “ gestal tllnknownE r r: // wia^ knows wlyl migiu lx: next? 

if (nCTD — 0) // If we haven't connected to the library 
yet_ 

I 

// NUTEiIIk: library name is hiud coded here. 

//1 try to isoLilc llir glue codr^ one file per library'. 

//1 have lud developed pa,ss in the library name to allow 
// plug in type ,suppon. Additional cwlc has to be added lo 
// each entry points glue routine to support luuhiplc or 
// s-wiiching connection IDs. 

.lOSKrr “ GetSharedLlbrary lT\pDemoLibrary’', flArchType, 
kl;t>udCFrug, 

ittClO. bmainAddc. errHessage): 
if fsOSErr 1= noErr) 
return sOSErr; //fXiPS! 

I 


// If we haven't looked up this symbol yet... 

if ((Ptr) 'pSyffiAddr = (Ptr) kynresolvfidCFragSyTuboiAddress) 

! 

// ...look It up now 

sOSErr Findsymbql(sCIpSyTuKame.pSymAddr »&syriiClass) : 

l£ tsOSErr f- noErr) //in case of ciror*. 

// ...clear the pn)ceduit puinicr 

*CPtr*) ^pSymAddr = (Ptr) kUrvresolvedSymbolAddress: 

#if IGENERATINGCFM //if this Is classic 68k code... 

•pSymAddr “ (Ftr)lfevRout lttGOescriptorTrap( (ProePtt) 
•pSyaAddr, 

pP roc Info. L IS ATy pe); // ... create a muUnc descriptor... 

#cndlf 

1 

return sOSErr; 

) 

r Public funcUons & globals 7 
pascal void Do Demo(void) 
t 

static Do_De»oPtocPti sDo^DemoProePtr = 
kUnresolvedSymbolAddress: 

// if this symbol has not been setup yet.,. 

if ({FtrJ sDo_DeinoProcFtr “ (Ptr) kEnresDlvedSymbolAddressJ 
Fiiid_Sy!&hoi C (?tr *) 

&sDo_DemoP roePt r."^ pDo^Deno"* kDo^DewoProcIn fo): 
if f(Ptr) eDd DemoFroePtr 1= (Ptr) kOoresolvedSyiaboiAddresB) 
sDo DamoPfoePtrC); 

1 

pascal void Set^DemoValusClong pLong) 

I 

static Set_BemoValueProcPtr sSet^DemoValueProcPlr * 
kUnresolvedSytabo lAddress: 

// if this symbol has not been setup yet... 
if ((Ptr) sSet_DciiioValueProcPtr “ (Ptr) 
kUn r eso1v edSy mboiAdd re as) 

F1 nd_Syffibol ((Ftr') &sSet_DeaioValueProcPtr. 

“ \pSet_DeiisoValue"' ^ kSet^Demo Value? roc Info 3: 
if (CPtr) sSet_DenioValueProcFtr 1= (Ptr) 
kUnresolvedSymbolAddresn) 

sSet.OernoValueProrPt r (pLong); 

I 

pascal long GeL_DeiiiDVaiue(vqid) 

[ 

static Get_De]ao¥alueProcPtr sGet DenoValueProcPt r * 
kUnresolvedSyiiLbolAddreafi: 

// if UiLS symb<d has not been scTup yet.., 
if ((Ptr) nGet_Dej«oValuePtocFtr = (Ftr) 
kllnrflRol ved Symbol Address) 

Flnd^Symbal ((PLrV) ^sCetJemoValueProjcFtr, 

" \pGuL„DemoValue’* . kGet_DenioValueProcInfo 3 : 
if [(Ptr) sCetJDeraoValueProcPtr 1= (Ptr) 
kUn r e soIved S ymb o1Add r e s s) 

return sGet.DenoValueProcPtrl); 
else 

return Oh; 

) 

pascal Plr Get_Deiw>String(vold) 

I 

static Get^DemoStriugProePtr sCxeT DerooStrlngProrPu = 
kiln resolvedSymbolAdd ress : 

// if this symbol hits not been sciup yd... 
if ((PtrJ fiGet_DctooSLi:lugProcPLr = (Ptr) 
kUn r s so1V ed Symbo1 Add c c s s ) 

Flnd_Syjitbol ((Ftr*) &sGet_DemoSttlngProcPtr * 

" \ pGet_UemoString" .kGetJemoStringProcInfo); 
if ((Ptr) EGet_D€tnoStringProcPtr 1^ (Ptr) 
kUnresolvedSymbolAdd ress) 

return sGet DenoStrlrtgPr&cPt r(): 
else 

return OL; 


Note: The alKwe rcHiriaes will silently do nothing if tlieir 
Mnd_Synibol call fails. Roulinus I hat do this .sort of load/fesolve 
on the fly should always have a means to Ixiil <iut in case there 
are any errors. For example, return OSErr, use some kind of 
exception iiiecli:misiii, etc. At Lite least, have Find^Symbol pul up 
a fatal alen. Ihis is left as an exercise for die (migrainmen 
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Noiiis ON Using thf New’ [Fat] RoLniNi'Di^RiFroR [Trap] 

When calling NewlUmtineOescripEor from clas.sie 68K 
code, (iiLTc arc two passible intentions. The Hrsi is source 
comixUibility with ccxie ported to CFJVI (cither Power PC or 
68K CFM). When the code is compiled for CFM, the functions 
create routine descriptors that can be used by the mixed 
mode manager operating on that machine. When the code is 
compiled for classic 6SK, these functions do nothing so that 
the code will run on Macintoshes that do not have a Mixed 
mode manager The dual nature of these functions is 
achieved by titrning the CFM calls into “no-op'* macros for 
classic 68K: You can put “NewHoutineDescriptor*' in your 
source, compile it for any architecture, and it will run 
correctly on the intended platform. All without .source 
changes and/or conditional source* 

Ttie other intention b for code that “knows" that it is executing 
iis classic 68K and is .spetiftatlly trying to c^all code of another 
architecture using jnixtxl trKxle. Since the routines were designed 
with claxsit: <-> CFM source compatibility in mind, ihis sa:ond arse 
is Irc^atcd s|3eciaL I*or classic 68k axle t() t:reate ix>uLines descriptors 
for use by mixed mcxle, i! must call tlie “Imp" versions of the 
routines (NewRouLinelX-striptorTrap). *rhese versions are only 
availalile to classic 68K callers: rigging tlie interl'atx^ to allow calling 
them from CFM ccxle will n^sult in runtime failum Ixecause no 
shamd library iniplernenLs tjr cxtx>its tliesc* lunctions. 

This almtxst aptx^ars seamless until you tx>n.sidLT “fat" routine 
descriptors and the advent of CFM-68K. What docs ’Taf mean/ 
CFM-()8K is not emulated rm Power PC and Power PC is not 
emulated on CFM-68K* It tJiakcs no sense to creiite a routine 
descriptor having lx>th a CFM-68K routine and a Ikiwer PC native 
n>utine pointer. '11ieR‘forc “faf is tlefined to Ixf a mix of classic 
and CFM for the hardware’s native insmiction set; on Powt^r PC 
fat is classic and Ikjwer PC txitive, on a 68k machine with CFM- 
68K installed far is classic and CFM-68K. 

By definition fat njutinc descriptors are only constructed 
by code that is aware of t!ic architecture it is executing as and 
that anoiiier architcaure exists. Source compatibility Ix-tween 
code intended as pure classic and pure CFM is not an issue and 
so NewFaiKoutincDescTi[nor is not available when building 
pure classic ctxJe. 

NewFatRoutineOescfiptorTnip is available to classic code on 
lx)th Power PC and CFM 6HK. The classic ccxie can u.se the code 
fragment manager rtJUline “FindSymbol" to obtain the address of 
a routine in a shaa^d library and then construct a rt>utine 
descTiptor whlh both tht* CFM nxjline and classic routine. 

Air)ijt Mlxfo Mode and Routine Desc riptors 

In the l^eginning (1984), there was the classic Macintosh 
programming modef based on the Motorola 680x0 processor 
and t‘ode segnienLs. Then in 199b the PowerPC processor was 
introduced. There was concern alioul compatibility with 
existing 68K applications (int:luding the Finder), and the first 
step in atkire.ssing this concern was WTiting a 681*0040 
emulator which allowed 68K code to nin unmcxlified in the 
new environment. As part of this effort, a itiethod had to be 


devised to switch l>etween the native PPG and the emulated 
68K modes — dius, the Mixed Mcxle Manager was born. 

'the Mixed Mode Manager is system software that tTianage.s 
mode switches l^etween code in different inslniction set 
architectures (ISA’s). An ISA is the set of instmetions 
recognizer! by a particLilar processor or family of prtK:ess<irs. You 
indicate die ISA of a particular routine by creating a routine 
descriptor for that routine. 

Note: For more infonnaiton alxiut the Mixed Mtxle Manager, 
read iLs chapter in Imide Macintosh: Fou’erPC System Sojiufare, 
Tltc d(x.’umentation also applies to CFM68K — just consider 
“native" code lo Ix^ eilher PowerPC or CFM68K. 

Code Fragment Manager 

CFM was developed initially for Poweii^C-based Maciniash 
computers lo prepare ccxle fragments for execiitton. A fragment 
is a blexjk of executable cotie ancl its ass<x:iaicxi data. On PowerPC- 
based Macintosh computers, native programs, applications, 
libraries, and slant Uik me code are packaged as fragments. 

In 1994, CFM was poited back to 68K. The Mixed Mode 
Manager was again used to handle transitions between classic 
68K and the CFM conveniions for the CPLl it is running on, ix\, 
on PowerPC it iiin handle classic to PowerPC transitions, and 
i>n 68K it can handie classic to CFMtiBK iraasitions* Classic 68K 
code is generally ignfjrani of imxie switches while CFM txxle 
must I'te aware of ihcrii. Classic (sHK code can treat a routine 
cles(Tipior pointer as a classic 68K proc pointer, but CFM code 
cannot treat a routine descrijxor as a (>rtx^ pointer. 

Summary 

Calling CFM from classic code may be necessary for a 
number of rea.sons, particularly if ytju want to take advantage 
of both the classic and CFM libraries. It may also be the 
simplest and easiest metluxl of adding phig-in support to an 
existing 68K or fat upplicati<3n without having to port die 68K 
code to CFM68K. 

■Ibis article discus^ses simie stmightforw'arcl meiluxLs you can 
use to aiil CFM ccxle from classic c<xJe. There are problems, 
however, that you ought to consider wlien trying to buikl routine 
descriptors for C routines in a shared lilirary. 

FuK'niER Referengi-: 

■ Imide Maemtosh: PoimFC System Software. 

• Fm^ments of Your ImagtmUkm by jcx: Zobktw, Atidison- 
Weslcy. ISBN 0-201-48358-0* 
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hy Dave Polaschek 


Desktop Printing Revealed 


Wm the introciuciion of Sy^stem 6 and 
MulitFinder in I9S9, Apfde inlroduced 
hac^nmnd priming. For the fii^t time, a 
user could regain contml of the Macintosh 
almost immediately after printing a 
documeni, ivbUe IbeprirHer driiKrpnx:essed 
the dcKumem in the Ixtckground. Classic 
background pointing has Ixxm far more 
nMist than anyone may haw imagined, 
and it’s still the basis of much of today’s 
printing technology, including desktop 
printing, I In. fortunately for dewhfxfrs 
Interested in supporting desktop printing the 
interfaces to background pmiting have 
nmiained largely und(K:ummted. 

In 1994 die desktop y>nniin^ 
architecture was introcluced witli tlie 
StyleWriter 1200 driver and biserWriter 83- 
From iLs initial release to the present^ 
desktop printing lias existed as a collection 
of extensions and invisible applications. 
Wliile this Iuls not created a clear ancl 
simple picture for develoiXTs interested in 
supporting desktop printing, this 
Leclmology sliows every sign of thriving for 
a long lime to come, so understanding its 
architecture is more vital than ever 

While the complete stoiy is far from 
wniten, and things will certainly change 
again with the introduction of Rhapsody, 
til is artic:le will cover background printing 
for all pre-Rhapsody versions of the 


MacOS. This includes the significant changes that will make 
Desktop Printing accessitile to third party developers. If youVe 
currently got a printer driver, this anicie describes everydiing 
you need to add suppon for desktt>p printing. 

Ciassk: BACKCROifND Printing 

Tlie way eady Irackground priming worked was that printer 
drivers would save each page as a QuickDraw^ picluie in tlie data 
fork of a temporary file (a spool file) in a special folder (the Spool 
Folder) within the System Folder. There was also information 
stored in die resource fork descriliing the page fonnat, documcnL 
name, and other jol> infbnnation, as well as offsets to the Ix^ginning 
of tile data for each page. A special application (Rackgnonndei) 
launched by MultiFindcr at startup time (in Sysictn 7, Backgrounder 
was inc'orpomted into Finciei) would see die document created l>y 
die printer driver and would launch PrintMooitor, which would mn 
in die liackground, reeding the spfKil file lo die printer driver 

PrintMonitor |^rfonns its magic by calling the printer driver 
in much the s^ime way as an application would, except rather tlian 
your drivers PDEF’ 0 resource getting called, its 1*DEF’ 126 
resource — which has die same fonnat as die TDEF 0 resource 
— is called. A spec’ial PrGeneral call Is sent just after PrDpeii has 
lx:en ciilled (beft^rc PrOpenDoc has bettn oallcxl), to provide the 
printer driver with the pointers to notification fLinctions it will need 
to Qilf PrintMonitor then prints each page by replaying die storcKi 
page data to the driven. This method of iiac:kground printing Is still 
used by die Printing Manager texiay in two cases: wlien dc.sku>p 
printing isn't installed (or lias lx!en disabled) and when die Finder 
isn't Rinning (usually lx.'aiu,se At F.tLsc is mnning instead). 


niANKS to reviewers Alan Ikck. Rich Blanchard, Paul Danlx>ld, Ihieii TTuang, Ingrid Kelly, and Donna ijee. And thanks lo 
Jimmy Biiffeii for die .soundtrack. 

DAVI: I^CILASCIIFK Cdavcp@I>csi com, liltp://www .best,com/*"davep/J dcx.\sn't work for Apple anymore, hut he still finds 
liiinsclf writing tlic.se anicles. Most summer evenings wiil find Dave watching the St. Paul Saints from his season-tirket seat five 
rows behind the umpire, wlio often secTns to .show a snrprisir’tg lack of knowledge as to where the .strike zone really is. Fear 
not- Dave nmkes sure the umpire gels pn>perly cducaied over ihe course of the season. 
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Getting to know tia^ssir background printing mean.s you 
need to know the staiciure of its spotii file. Tile resource fork of 
the S}XX)1 file contains the following resources (note that all 
structures mentioned in this docainient have 68k alignment): 

* *PREC' 3 — the print record 

^ 'alls* -8192 - an alias to the driver that created the 
spool file 

* 151 - the small icon to display for the spool file 
in the PrlntWonttor window 

* "FREG* 124 the printer name 

‘ *FKHC^ 126 the Job infonHatlon 

typedef f 

short version: // always 0 

short flags; // always 0 

short numPages ; // ujUI nunihcr of pages in Uic spool Hit: 

short nnmCop 1 E!3; // total fnimltcr of copies for lUc s^xHil tile 
OSTy po c r t r! // the creator type t>r the driver used to 

// create the spool file 

Str31 appName; // the appUcatitm naaic used to print the 

// sjxtot file 

I PREC236Record* ‘*PaECi26Mandle: 

< 'STR * -8192 — the filename of the printer driver 

* 'STR ‘ -8189 — the document name [always padded to BO 
bytes) 

The datu fork of the spool file begins with a SpoolHeader 
structure, followed by the pages* 
typedef struct I 

short version; U siKiuld always be t 

long f ileLen: // length of file induding licadcr 

long fileFlags; //^thoukl alwayjt be 0 

short numPages: 

TFr In L print Record ; // used only if PRHfi 5 can’t he read 

) Spooilleader, * SpoollieaderPl r, ' *SpoaSheaderHdle; 


typedef struct t 
long pictFlags: 
Picture thePict: 

1 ong pageOffset; 

1 Page: 


// should always lx: 0 
// vaitihlc length 

// <rffsct tf) the bqynnlng of this pge’s 
// PiiJ 


'Itic Spool file is Cleared by the tlrtver in ihe Sp(K)l Folder 
or Print Mon ilor Dtx'u menus folder within the Sysieni Folder (tir 
in tlie CLirrctil tiefauli desktop printer folder if MacOS H desktop 
printing is active — you can find die correa folder with 
FinclFolder and the kFriniMoniiorDtK’sFolderType scleclor). 
The s|X)ol file has die name of die dtxrumeni being printed. If 
you're putting the hie directly into the desktop printer Foltler, 
you'l! need to appenrl "(print)" lo the filename (which means 
you may need to shorten the cUxrunient name). Spool files tliai 
are being written have a type of ^?job' and a creator of ^prmt\ 
Once the file is completely written, the driver changes the type 
Uj 'pjob'. When die version of Deskto[) Printing lliiU sup]X)its 
third-party diivers is available^ your driver also needs to send 
an Apple event to the Finder telling ii that a new sp<K)l file was 
created (more on diis lielow'). 

When PrintMonitor (or Desktop PrintMonitor) prints a job, 
it calls the driver's PrOpen routine and then calls PrCjeneral 
with die sirucLure shown lielow (sec ihe DTPNotification.h 
header file, available on MacTech’s web site at 
<http://web.xplain.com/mactech.com/magazine/featufes/fitearchives.html 
>, for specifics). PrintMonitor then calls l^rOpenDot with a 
pidlePruc that the driver needs to call periodically. 
PrOpenPage and PrClosePage will get called for each page of 
the dfxaiment, and the page will be printed to llie driver. 


// Function prcuotypes 

typedef pascal void t*AeynchErrorNotificationProePtr) 
(StringHandle string): 

typedef pascal void t *RndNot i f icat ionProcFtr) 0: 
typedef pascal Boolean (•InForcgroundProcPtrJ (); 
typedef pascal void (*Statusf1essageProcPLr) (Si ringRandle 
string): 


const short kFrifitMonltorPrGeneral = -J: 


typedef struct 
short 
short 
long 


IQpCode; 
lError; 
IResarved; 


THPrint 

short 

long 


hPrint: 
noProcs: 
iReserved2: 


// kPriniMtmUorPrCicncral 

//1) = PrintMonitor 

// 1 = Ocskiop Prim Monitor 


// irpp fo put up a (toTificaiion 

ErrorMotificationUPFpASyiicNut 1 f ical lonPror: 


// UPP lo Uike down ihc m^iiftcaiion 
EndNotificationlIPP pASyncUnnotifyProc i 


//1IPP to see if we arc in the fore^mnd 
Inforcground UPP pTnForegroundPror: 


// UPP 10 update ibc status message 

// (avalbhle onlv with desktop prioiing that supp<ins third parries} 
StatusMes&ageUFF pBtatusHessageProc; 


] TnesktopPrintingData: 


When printing with backgnamcl printing, b<ith PrintMonitor 
iind Desktop PrintMonitor will put u DialogPir into tlie low- 
memory' glolxil ApplScntlch jtisi lx.dbre ciilling PiOj>enDot\ 11ie 
driver should put .suitus nie.ssages inU3 the first item in tliat dbilog 
using GetDialogltem and SeiDialogllcm'rcxt. 

If rhe PrGeneral call .says ihai priming is occurring from 
Desktop PrintMonitor (which is a laceless background 
api>licaijc>n)* no diukjgs or alerts should be' displayed. The rme 
exception is that [)t*sktop PrinrMf>nitor patches SlopAlcrt and 
ParamText. If you call l^araniText and then StopAleit, the Finder 
will display an alen fur yf>u wiili the texi youVe .set. However, 
the filter prtK pas.setl into StfjpAlcrt will not l>e culled. 

Dlsictop PKiiyriNt; Today 

Desktop printing was intriKluccd with the LaserWriiCT 8.3 
and ihe SlyleWriLer 12()() [irinlcr drivers, and it uses much the 
same approach as classic background printing, (airrently, 
desktop printing only .supports Apple print drivers, bul the 
additkms de.scribed in this scciion are things you will need to 
incoiporale into your drivers in order to work with <iesktop 
printing in the hilure. 

The atiditional re.sourt:es a driver nccxls to add to support 
desktop priming are the icons for ilie dt'sktop printers. As a 
driver developer youH need to supply a full *BNDI/ Te.sourcc 
with your driver’.s cTeart)r. Beyond the tyjies and icoas youVe 
prolvably ala^ady got in your driver (lor the driver itself and any 
fircferences file), you1l need to add icons for the types klpnn*, 
*dpcn\ and 'dpna*, which correspond to a “normaP desktop 
printer, a defaiill desktop f)rinter (with the heavy line around it). 
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and an inactive (or unavailable) desktop printer. LaserWriter 8 
has a slightly different scheme for setting the icons for desktop 
printers, in tliat it retrieves them frcnn tlic PostScript printer 
description (PPD) file for a given printer. 

The STYLEWmiiiR 2500 Bundle and Icx>ns 

Wlien an Apple driver creates a spool file for desktop printing, 
it places the file m the same folder used by classic background 
printing. Tire Desktop Printing Extension will take care of moving the 
file to Utc desktop printer and Ix^ginning tlic jmKess of actutiDy 
printing the document. ITie resources defined immediately following 
are those added to the spcKjl file when deskU)p printing is active: 

, ♦piNX' -S200 - th€ pagf index resource 
• *jobi’ 1 “ the print job information 
typedef struct t 
short count: 

long pageof f set 111 : //The offset from the bcKinninj 5 of the flic to 
// the pafieReeorxi (i.e., for the first page. It 
// would be sizeof(SpoolHeader)) 

\ Pagclndex, VPagelndexPlr ^ ’* *PageIndexHdl: 

// Prim priorities 

^define kPrintJobUrgent GxOOOOOOOl 

#define kPrintJobAtTiiite 0x00000002 

/fdefine kPrintJo'btJorjiial 0x00000003 

^define kPrtntJnbHoldirvg 0x00001001 

Lypedef atrtie t ( 

short fIrstFageTcrPrijit; // ftrsl page in ihc spool file to prim 

s ho r t priority; // print priorit)' 

short nuniCopies: // luUiJ number of copies 

short nimP ages: // total number of pages in the sptjol file 

unsigned long timeToPrlnt: //(when priority is kPrimjobAtTime) 

S t ra 1 doc 1 traicn tName; // name of the documeot 

SLtll applicati unName; // the tiame of Ihc appheaiioii 

Str32 prliiterName: // should match PRHC 124 

] FrintJoblnfo, '* Feint Job Inf oiiandle: 

Another addition is a new way to change the default desktop 
prinLcr An applicatkm or driver c:an send an Apple event to the 
Finder as shown lielow, (Note lltal SendAEToFinder jusl sends ihc 
event to the Finder with an eventlD of kFinderExtension.) 

^define kDesktopPrinting 'dipx' 

^define kFindexExtension ■f 0 Kt' 

typndnf struct: [ 

OSType pfeCreator; 

OSType oxLonsiouTypo: 

Str31 dLpN^i?; 

I SBtDTFHvent; 

OSErr SetDefaultDTP(StringPtr dtpName) 

1 

OSErr err^noErr; 

Snt.DTPEvcnt my Event: 

tnyEvOiU . pieCreator = kDcsktopFrintlng; 
tnyEvent. extensionType - ' pf pr' : 
pStrCpyCmyEvent.dtpMame* dtpName); 

err = SendAEToFinder((Ptr) SmyEvent, sixeof(SetDTPEvent)f: 
return (err); 


Desktop Printing Tomorrow 

With the intioduction of MacOS 8, desktop printing will no 
longer be a separate extension. It will be integrated into the 


Finder and tlierefore available in most cases, A user can stiF 
disable desktop printing by disabling the Desktop PrincMoniroi 
and Desktop Printer Spooler in Extensions Manager, though. In a 
future version changes will be made to make it possible for tliind 
panies to integrate support. Tliese changes are also being made 
to die previous versions of desktop printing so third parties (that's 
you!) can use desktop printing on systems which have not fjccn 
upgraded to MacOS 8, For details on licensing the Desktop 
Printing software, contaci Apple’s Software Licensing department, 
at (512) 919-26^5 or <swjicense@apple.com>. 

Desktop printing installs a Gestalt selector to tell you if third- 
party drivers can be supported. If desktop printing is available, 
hut this selector does not repf^rt that third-parly drivers are 
supported by desktop printing, you will need to use the metliods 
described in the Classic Background Printing” section above, 

i^^define kGestaltPFEFeutures 'dtpf' 

#defiTie kThirdPartySupport 0x00000004 

looleati ThitdPartyDriverSupported(void) 

t 

long response; 

Boolean result = false; 

USKrr err = Gestalt(kGestaltFFEFeatures♦ fitrespouse); 
if (eci: noErr) 

result “ U(response & kThirdPartySupport); 
return result; 

I 


When non-Apple drivers aie supptirted by desktop printing, 
your driver needs to write your sjxxjI files directly to tlic desktop 
printer folder with the type of ‘?job’. When yCMJ are done spooling, 
you need to change the file's type to 'pjobV The driver can 
determine ilie current default desktop printer folder, and many oiiicr 
tilings, by calling the Gestalt routine with the desktop printing 
extension selector. The selector is kftpx’, and the information Is 
returned to you in a handle, Wlicn you're done with the handle, do 
not call Dispose! landle on theDTIdast and the GestaltPFEInfoildie. 


typedef struct t 
short vRefRum; 
long dirlB; 

Strll dipNamo; 
OSType driverType; 
Boolean IsUofatiit; 
Str32 printerNaaie; 

Str32 toneUsine; 

1 BTPTnfo* *DTPTnfo?tr; 


// vRcfNqm (>f the de?iktop printer holder 
// Directory ID of the tleiiktop printer 
// Name of the desktop printer folder 
// Driver’s creator 

// [s this Ihc dehuilt desktop prioicr? 

// Nciwofk name of the primer (only for 
// UserWriier 8.4 desktop printers) 

// ^mc of the printer (<)□!>' fi>r LaserWriter 
// S.4 desktop printers) 


typedef SLrucL 
[ 

Long structversion: //Version of Ihissiructure 

short numDTFs: // Number of desktop printers In ihe lust 

Handle theDTPList; 

I GostaltFFEinfo. “GestaltPFElnfoHdle: 


Wlien you're done writing the spool File, you need to send a 
Core Apple event to the Finder with the following direct object key: 

typedef struct ( 

0 STyp e p f e C r e ator; // Set tliis to' dtpx’ 

OSType pf sEventType: // Set this to pfee' 
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F S S pec dtp Spe c: // 'llic liJc spec of the desktop printcf where 

// the new spooJ file was atfM 

I SyncBTFEventDat a: 


Tlicre arc also added calls for this version of desktfip 
printing. Specifically, there arc three new PrCjeneral that 

a driver neetls to .support: klsSaiiiePiinterlnfo, kGetPrinterlnfo, 
and kSclDefaultPrinterlnfo* 'lliese selectors enable the desktop 
printing extension to decide which of the driver’s desktop fmntcrs 
is the current default printer, to detennine whether it needs to 
create a new desktop printer, and to infonn the driver that a 
desktop printer has l:)een seleaed as the default. The structures 
yonll need to use to supptrrl these selectors arc shown telow. 

// D’JP pruUcr lyjKrs 

\ kSerial, kAppietalk, kTCFiF. kUnkiiown ]; 
enoni t kPrinterPort* kModemPort I: 
euu® { 

kGctPrioterInfo “ 23, 
kIsSamePrinterTnfo ^ 24, 
kS€tDe£aultPrinLorTnfo ” 25 

J; 

typedef struct [ 

uho tt port: // kPrinicrPtiri or LModcmniri 

I SerialPrinterlnfo; 

typedef slruci I 
Str32 nbpMame; 

Str32 nbpZone: 

StrS2 nbpType: 

1 App1eTaikP rin t e rInfo i 

Lypedof struct I 

Str255 TGPIPAddrcSs^ 

] rCPlPPrinteriiifo: 

typedef struct t 

Str31 dtpBefaui tNarae; // Dcfauli naniL- to he used for the desktop 

// printcr lhe desktop prbiimg cxieasion 
// will add a suffix if there's a cooflici 
// with other desktop printers, 

short p rint e r Ty pe: 

// Info specific to cadi diss of iwifitcTs 
union ( 

Serlalprlnterlnfo seriallnfo^ 

AppleTalkPrinterlnfoapplsTalklnfo: 

TCPTPPrinterTnfo TCPIPInfo; 

f u; 

// OfHkinal drivcr’^pcctfic inftirmaiitMj can be appended here. 

I DTPPrinterlnfo* "‘DTPPrint^rlnforiaiidlif: 

typedef struct I 

ahort iOpCode: 

abort lError; 

long ICoimnand' 

DTPPrlmerlnfoHandle printer Info; 

] TFrlnterInfoFi GeneralDe i a 

When your driver Ls selected in the Chooser, tieskujp 
printing will call your driver via a series of PrGeneral calls. 
First, you1l get called with the klsSainePrinterlnfo select{)r for 
each of the desktop printers created by your driver in order 
to determine which is the currently selected printer. Your 
driver responds by filling in the iError field of the 
'ITrinterlnfoPrGencralData record. If the primer that your 
driver thinks is current matches the information passed in 


with the klsSamePrinterlnfo selector, the driver responds by 
setting the iHrror field to noFrr. If it’s not a match, the driver 
sets the iFrror field to -1. 

If the printer selected in the Chooser is not among the 
desktop printers owned by your driver, desktop printing will 
create a new desktop printer and call PrGeneral with the 
kGetPrinlerlnfo selector to get the information for the 
selected printer At this point, your driver should resi 2 :e tlic 
printerlnfo handle and fill in the printer information. You 
need to fill in the dlpDefaultName field with the name you'd 
like to see a desktop printer created with. Also note that your 
driver can append as much {(tr as liltle) extra printer 
information as you'd like. Once yoifve returned the 
information, the desktop printing extension will save this 
information into the desktop printer. 

If a user selects one of your desktop printers via the Set 
Default Printer menu item in the Printing menu (which appears 
in the Finder when yoirve clicked on a desktop printer), your 
driver will get a PrGeneral call with the kSetDefaultPrinterlnfo 
selector. When you receive this call, you should change any 
internal settings your driver maintains so that the printer 
pointed to by the DTPPrinterfnfo you received is now the 
currently .selected printer for your driver. 

Tire Futitre !s Now 

If youVe currently got a driver that supports classic 
background printing, your best bet for future compatibility is 
to add support for desktop printing. However, if you’re just 
starting to tackle background printing now, while you could 
implemeni supptjri for MacOS 8 desktop printing only, we 
strongly recommend that you suppon [he current desktop 
printing architecture and classic backgroumi printing, as well. 
That way your users will fiave a mcjre consistent experience 
when printing, regardless of which version of the MacO.S 
they're running. B 



Apple’s develop™ 
back issues are 
available for only 
$10 per copy. 

To place your 
orders, call 

800 /MACDEV- 1 . 
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hy Apple f)eveloper Support Center 


Macintosh Q & A 


Q; I*m debugging my PCI native driver and notice 
that tlie dCtlFlags field of my Device Control Entry 
(DCE) has some undocumented bits set What do 
these flags mean? 

A: Hie Cimkent bits hi the dCtLh’lags field of the DCE are: 

« bit 0 " VMTiiiniune — Tliis bit indicates tliat your 
device driver is VM safe. See I'echnote NW 
<http://dGvwor[d.applexom/dev/technotes/nw/nw_13.html> for 
details. 

• bit 1 — reserved. 

• bit 2 — kniDriverGestaltEnableMask (in 
‘'DrivcrCjcsuili.li’O is set if the driver suppons the Driver 
Gestalt mechanisni. See l>esigning PCI Cards and Drivers 
for Power Macintosh Computers for a description of 
Driver Gestalt. 

• bit 5 — Native Driver — Set if tlie driver is a native 
driver (ndtv). 'the system will set this bit when it loads 
your native driver. 

• bit 4— Concurrent — Set if the native driver supports 
concmrent operation. When loadkig a native driver, the 
system sets this hit based on the kDriver!sConciirrent 
field of the driverOSRuntiinelnfo.driverRuntiine field of 
your DriverDescription, See Designing PCI Cards and 
Drivers for Power Macintosh Computei-s fora description 
of concLirrent drivers. 

• bit 5 — dOpenedMask (in “Devices.h”) is set if tlie 
driver is open. 

• bit 6 — dl^AMBascxlMask (in “Devices.h") is set if tlie 
dCtlDriver field Ls a DRVRl leaderl landle rather than 
a DRVR Header Ptr. 

• bit 7 — drvrAcLLveMask (in ^'Dcvices.h") Ls set if Llie 
driver is currendy processing a request. 

• bit 8 — dReaclEnableMask (in “Devices.h”) is set if the 
driver liandlcs _Rc“ad rcquesLs. 

• bit 9 —dWriCEnableMask (in “Devices.h’’) Ls set if the 
driver liandles _Write reciuests. 

• bit 10 — dCllEnatjleMask (in “Deviccs.fi”) Ls set if tlie 
driver handles _Contio! requests. 


• bit If — dStatEnablcMask (in “Devices.h”) is set if 
the driver handles ^Status requests. 

• bit 12 — dNeedGcxKlRyeMask (in “Devices.h”) is set 
if the driver needs a ''gocxlbye” _Control call licfore the 
application lieai> is reinitialized. 

• bit 13 — dNeedl'imeMask (in “Devices.h”) is set if 
the driver wants periodic SysieniTask Lime througli the 
“aecRun” _Control call. 

• bit 14 — dNeedLockMask (in “Devices.h") is set if‘ 
the driver requires that its DCE and code lx locked at 
all times when the driver is open. 

• bit 15 ^' reserved. 

See Inside Macintosh: Devices for more infonnation 
aix>yt bits 5 through to 14, 

Q; I’m calling the serial driver to clear XON/XOFF 
flow control but flow control is not being lifted. 
What’s going on? 

A; You have sainibied acioss a bug in Apple system 
software (ID 1635221), The File System Manager patches 
_Conirol in sutli a way that tlie .serdCIrXOff (esCodc = 
22) is niistaken for a block device “ReRini Media Icon” 
(esCode 22) caM. I'his causes the serdClrXC]>fT to never 
make it lo the .serial driver. 

The simplest workaroLind is to clear ioVReflsium before 
making the serdClrXOff call. The following code 
snipper demonstrates tliis technique: 

OSErr DoCl&arXOff (short .■jerlalOutDtvrRefKuiiL) 

1 

CntrlFarain pb: 

pb. ioCRefNiim = serialOutflrvrRefSuiD; 
pb.csCode ^ serdClrXOff: 
pb, ioVRefNuni “ 0: 

//This afaty\'c Unt is required beiaust of a buj; 

// In system .software,Hie w<>rkar(Jund.deaFinfi 
// ii>VfiefNdm^ should benign when the bug is fixed 
// in ftiruiY systems. 

ruturxi { rBContrulSync ( (RiiriEifllkFLr) ^pb ) ): 

I 
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Q: Sometimes, MacsBug generates a PowerPC 
umnapped memory exception with an address that 
starts with the symbol BowelsOfFheMemotylVIgr. 
What does this mean? 

A: When you are displaying addresses in Macsbiig, 
MacsBug sIkjws offseLs fn^m iJie last symbol iL can 
find. In the Modern Memory Manager on Power 
Macintosh computers up to MacOS version 7.6, the 

last symbol was_HSetStateQ. The code after 

_HSetStateQ consists of various internal Memory 

Manager subroutines. So, if there's a hang or crash in 
an internal Memory Manager subroutine, it shows up 
in MacsBug as_HSctStatcQ+xxxxxxxx. 

Various system software engineers were tired of seeing bug 

mtxjits dial said_^HSctStaicQ was crasliing, s<^ fx^ginning 

with MacOS 7-6, we decided to add a new last symbol to 
the Memory Manager. As a consequence, bug reports 
would fx: somewhat mcjm infonnative. We Uioughl of 
naming tiie new symbol Yourl leaplsCoixupt (since tliafs 
usually die case when a progiam crashes die Memoiy 
Manager) hut decided on BoweLsOfTlieMemoryMgr 
instead Ix'causc diafs wlicre you arc. 

So if youTe crashing or hanging at 
l^)welsOfriieMemoryMgr-Hxxxxxxxx, type HC to see if 
your heap Ls corrupted (it proliably will Ix^) and then start 
debugging your code to find out how it got comipted. 

Q: What are the different Gestalt selectors for 
Macintosh networking? 

A: Here is ific breakdown: 

MaclCP 

The Gestalt selector for MacTCP is mtep'. 

• MacTCP versions 1.0 through 1.0.3 did not register 
this selector. 

• MacTCP version 1.1 returns a value <>f 1. 

* MacTCP version 1.1.1 returns a value of 2. 

* Mac'TCP version 2.0 returns a value of 3- 

A value of 0 is returned if the driver is not opened. 

AppleTalk 

Tfie Ge.stali selectors For AppleTalk are 'atkv' ancl 'atlk\ 
1 he 'atlk' Gestalt selector was intn^duced in AppleTalk 
version 54 fo provide basic version information. Calling 
Gestalt with the ‘atlk' selector provides the major 
revision version in die low-order byte of the fum:lion 
result. For example, passing the 'atlk' selector in a 
Ge-stalt call or through MacsBuG with a result of 
0x0000003G means that AppleTalk version 60 is present. 
(Please note that the ‘atlk' selector is not available when 
AppleTalk is turned off in the Chooser. ) 


The 'atkv’ Gestalt selector was introduced as an 
alternative in AppleTalk vet^ion 56 to provide more 
complete version information via the Vers' resource. For 
example, passing the ^atkv' selector to AppleTalk vcision 
60 through a Gestalt call or MacsBuG yields llie following 
L(3NG1N1^ result: Ox3Cl08000. 


Open Transport 

Ihe (jestalt selectors for Open IVanspon are 'otan' and 
^otvF. You c'du te-st whether Open Transport and its varicjus 
parts are available by using tile Gestalt function witli the 
‘otan' selector. Hie bits ciiiTendy used are defined by 
cxinstants, defined in OpenTnansix>rt.h and shown below. 


Gimm [ 

gestaltOpenTpt 

ge St alto p enT p tP re s ent 

gestaltOp enTp tLoaded 

ge s t alto penTptAp p1eTaIkP r es ent 

ge R t a1tOpenTptAp p1eTa1kLoa d ed 

ge St a1tope n Tpt TC FP r c s en t 

gestaltOpetiTptTCFLoaded 

gestaltOpenTptNetwarepresent 

ge s ta1tOpe nTptNe twareL d ad ed 


= “otan', 

= 0 x 00000001 , 
= 0 x 00000002 , 
= 0 x 00000004 . 
= OxQOOOOOQS, 
” 0x00000010. 

- 0 x 00000020 , 

- 0 x 00000040 , 
= OxOOOOOOdO 


If Gesiah returns no error and respontLs with a non-zen) 
value, Open Transport is available. To find out whetlier 
OT, AppleTalk, TCP, or NetWare are present, you can 
ex^imine the response parameter liiis iLs shown above. 
For example, passing the ‘otan’ .selector in a GesUill call 
or rhiQugh MacsBuG with a result of OxOOOOOOlF means 
that the Open I'ransptm is present and loaded, 
AppleTalk driver is also present and loaded, and 
MacTCP is present l>ul NOT loaded. 


The fotvr’ selector is used to determine the Open Transport 
Version in NumVersion fonruil. For example, fxissing tlie 
‘otvr' selector tiuough a Gestalt aill or MacsBuG to O'f 
veisLon Tl.lb9 yields foe foEowmg lONGlNT result: 
C)x0T116()09. (Note that OT versions LO tlirough 1.0.8 did 
not register this selector.) For more inft>riiiation on Apple's 
Version Numl3emg Scheme and NumVersion fonnat, 
pk'iise .see Technote OV12: Version Territory. 


Open Tmnsport/PPP 

The Gestalt .selectors for Open Transpori/PPP are 'oird' 
and 'otrv'. You can test whether Open Iranspoit/FPP 
and its various pans are available by using the Gestalt 
function with the 'otra' selector. The bits currently used 
are defined by consLanLs, defined in OpenTptPPF.h 
check OT/PPP SDK and shown below. 


enuffl [ 

geataltOpGnTptRemote Access 
gestaltOpenTptRemoteAcceSflPrfiflGtit 
ges taltOponTp tRcmoteAcccssLoa ded 
ges tal tOpeiiTp tRcmo L eAcc gssCH cii t Only 
gestaltOp eiiTpt Remot e Ac ceasPSatver 
gestaltOpetiTptRemoteAccessUPServtr 
gestaitOpenTptPPPPireseiit 
ge St a 1 tO p enXptARAPP re sent 


- * ntta", 

- 0 x 00000000 , 
= OxOOOOOOOK 
" 0 x 00000002 , 
** 0 x 00000003 * 
= 0 x 00000004 . 

- 0 x 00000003 , 

- 0 x 00000006 
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Note: If you are writting an control strip or sfiirtup item that 
uses 0|>enTraas[X)rt/PPP, you should \yc aware that it 
cakes a few event cycles for the remote access software to 
complete krading. Your software should check the 
gestaliOjx'nTpiReiiK HeAcc-essPreseni bit of the V>tnC gestalt 
ro see if remote acxress software is present, tlien jxaiodicaly 
check ifie gestaltOpen 'I'ptRemoteAccessLoacled to 
deieniiine if loading Ls coinpleted. 

More information on acessing using the Open 
Transjx)ri/PPP API Is availai)le in the Open Yraaspoit/PFF 
Developer Note found at llie OpenTransport web site's 
Reference and 'I'eclmical Documentation sectk>n (found al 
<http://17,126 .23.20/dev/opentransport/reference,html>). 

Open rranspoit/Modem 

Tlie Cxestait selectors for Open 'Iransport/Modem are 
'otino' and 'tHmv*, You can test w^hether Open 
■fransport/Modem and its various parts are available by 
using the Gestalt function with the ‘otmo' selector. 

cnuni t 

jjHStaltOpenTptModen **= *oti[io', 
gestaitOpenTptModeinBiresent = flxOOOOOOiJO 
b 

Q: Tm writing an Open Transport module that mnfornis 
to the rransport Provider Interface (TPI)-1 find that 
or passes data to my TPl using M_DAIA message 
blocks, rather than M_PROTO message blocks witli 
PRIM type being T_DA1A_REQ. WhaCs going c»n? 

A: Tile answer can lx: found at the bextom of the description 
of ‘r_DATA_REQ (7tpi) in Appemdix A-2 of STREAMS 
Mexiuies and Drivers (Unix Press, ISBN 0-13-066879-6): 

Ihe traasport [>rovider must also retrognize a message 
a( one or more M_DATA message blocks wiiliout tlie 
leading M_FROTO message block as a 'l'_DATA_REQ 
primitive, ThN mcs,sagc type will be initiated from the 
write (riA_OS) operating system service routine. 

Open Transf>ort deliberately uses this variant behavior 
as an optimization. By using M_DATA, Open TransptJrt 
avt>ids allocating a buffer for the M_PROTO header. As 
every memory allocation lakes time, avoiding this one 
makes the system faster. 

This behavior isn't seen on expedited data t>ecause 
the specification doesn't allow for tliis optimization on 
T_HXDATA^RFQ. 

Q; If my web server is mmiing along happily under 
Open Tran-sport (1,1 or 1-1,1), and tlie listener was 
bound to address O^O.O.O, what happens when 
someone uses tlie control panel and changes the IP 
number? Right now it appears to just make the 


listener go deaf, I don't appe^ to receive connections 
on the new IP number, and if I use the control panel a 
seetind time to switch back to tlie original IP number, 
I don't get connectkins for that IP number eitheTp 

!s there some event that gets sent to the listener tliat I'm 
not looking for that tells me when this happens? 

A: When an port changes its IP numl>er, il is at:Lually 
dosing and re-opening. When Open Transport closes a 
port, any endpoint tliai is piumlied to it is also dosed, 
hence you will get no further events on iljat endpoint. 

The first tiling you need to do is check for the provider 
events such as kOTProviderWiilCIose and 
kOTProviderlsClosed, 

You should also use tlie OTRcgi.sierAsCHent call and 
register a notifier for client events, such as 
kOTPortDisablecf kOTT\>rt Enabled, kO'ITortOffline, 
kOTPort Online, kOTCkisePort Request, 

kOl'Y ieldPortRequest, kOTNew Port Registered. 

You need to dose up your endpoints and rebind them 
when the interface changes, 

Q: I'm trying to call the Control Strip routines 
SBIsControlStripVisible() and 

SBShowIiideCootrolStrlp(9 defined in the header 
file <ControLStrip-h>. When I try to link the 
PowerPC code, I get a link error on these routines* 
Which library are they implemented in? 

A: Tiiere is no Pc^wcrPC lilirary For Control Strip calls. As 
a consequence, you must create a routine deserriptor 
and perform a Mixed Mode call to the 68K library. 

The following is an example of liow you can call the 
Cfintrol Strip routines from PowerPC code: 

/* Defined in cumeni Universal JlesiUef 7 
#ifndef _ControlStrlpDispfltch 
enura f 

_Cootrt>lStripDiflpatcli " 0xAAF2 
1: 

#endlf 

GENEKATINGCFM 

rv 

r if wc’rc not gcncraiing C^M, Ihtii ihe V 

/* 68K iniines in Uic ticadtrn> appiv instead. V 

rv 

jifinclude <HixedMode,h> 
jifinclude <0SlJtlls.b> 

Bnolftati SBTeControlStrlpVl^iible ( void ): 
pascal void SBShowHldeGontrolStrip(Boolean showitj: 

/• SBtsConimlStripVt^lc is a Pascal rouiinc// 

/* dispatdicd from the sclecior in DO. rciuniuig 7 
/• a B^iokan rcsuli 7 

pascal Boolean SBIsControlStripVisibl© £ void ) 
f 

enum 
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f 

uppSBIaConttolStripVisiblelnro 
kDODispat ched PascalStac kBa sed 

RESULT SIZE (SIZE_CODE (sUeof (Boolean)) ) 

DTSPATCHED STACK ROlTTINE.SELECTOR.SIZE (kPourayteCodc) 

return CallUnlversalProc ( 

GetToolTrapAddteas (_ConirolSlripDi^patch)* 
uppSBIsControlSttipVisibleTnfo, 0x00); 

1 

pascal void SBShovllideControlStrip(Boolean showTt) 
i 

enuBi 

I 

uppSBSliowHldcCont rolStrlpTnfo = 
kbODispatcbedPascelStackBaaed 

DIBPATGHEl}_STACO0UTI}^E_SELKCT0R_STZE (kFourByteCode) 
DISPATCHED STACK_ROUriNE„PARAJfE™ 

1. SIZE.CODE (siseof (showit))] 

I; 

CallUnlversaiProc ( 

CtitToolTrapAddresn CControlStripDispatch), 
TjippSBSUowiiideGont rol St rfpTnfo, 0x01, showlt) : 

) 

jfelse riwnGENERATlNGCFMV 
Jinciude <ControlStrip,b> 

#endif r GENERATINGCPM 7 


Q: I'm using tlie code from page 4-1 6 of Inside 
Macintosh; Processes to animate the cursor at VBL 
time, hut it crashed (with the stack crawl 
indicating SelCursor as the culprit)* What's up? 

A; When hardware cursor support was added to the 
system (System 7.5.2 for PCI Power Macs), SetCursor 
started requiring A5 to refer to a valid QuickDraw 
globals world. Despite die fact that tlie code io wliieli 
you refer accesses no glol^al variables, your app .still 
needs to make sure A5 Is set up for SetCursor's Ixmefii. 

An explanation of setting up A5 in a VBL task can Ik* 
found on page 4-13 of Inside Macintosh: Prtjcesses. 

Q; 1 am trying to find a way ff>r my application to 
determine if it is using a PostScript printer or noL 
For performance reasons, I'd like to send custom 
PostScript instead of a PICl' to the printer If 1 can- 
Is there an API tu find out if the currently selected 
printer uses PostScript? 

A; 'I'here is no giiuranteetl way of doing this* For Apple's 
bi.serWriLcT.s, you can detennine this by looking at the 
wDev field in the print record of the currently selected 
printer. In order to determine whether the cunent 
printer is PostScript, here is a quote that is hidden in 
one of our older Technotes, Technote QDIO "Piciure 
Comments — 'Hie Keal Deal": 

The liigli byte of tlie prStl.wDev Held of the print 
record identifies a printer driver species; a value of $03 
tells you that the printer driver Ixrlongs to the PostScript 
UiserWritcr driver ancestry... 


This lechnote may Ik? irseful to you if you haven't 
already read it. You should also look at fnside 
Macintosh: Imaging With QuickDraw tor more generic 
information on die print record. 

Pkiwever, aldiough the Apple l^iserWriier driver has a 
wDev of 3t third-party printer drivers for PostScript 
devices do not, so if your application deiennines 
whether or not to send PrjstScript based on wDev 
alt>iie, your application may incorrec'lly print with 
QuickDraw on ihird-party PostScript devices. 

Q; What's the logic behind die create/update preview 
behavior in the SFPGetFilePreview dialog? If I 
create previews for QuickTime movies, 1 
sometmies get preview movies and sometimes 
preview pictures. With QuickTime movies that 
already have previews, I sometimes get an update 
button and sometimes 1 get a dimmed create 
button. What determines the behavior? 

A: The expec'tetl behavior is this: 

PICT flies (or files that Qutckl'ime can import as PKTT 
a la the new graphic import components) don't have 
clLiradons to tliem so they can only have a preview 
PICT in the StandardFileFreview dialog. Movies can 
have both a prxster FiCf and a movie preview. 

In SiandaRiFilePreview, via the preview components, 
wlien a movie or PICl' hie is selected, the preview 
ccanponent w'ill first see if a preview already exists in the 
file, srf>red in tlie 'pnot' resource. Ihe "pnot' resource 
alstj identifies whether the preview is a PICT, a movie, 
etc. llie preview componenl then compares a timestamp 
in the 'pnof restjurce to tlie mtxliiication date of the 
.selected lile to see if the preview is current or not. If die 
■pnot' date Ls older than the last modiOcxl date of the file, 
StandardFilePreview will show the Uixlate button in its 
dial{)g (using the 'pmak' components to create the new 
preview if' the user selects this option). 

If no 'pnot’ resource is found in the selected file and a 
'pniak' component exists that can create a preview for 
the selected file type (QuickTime 2.5 supplies PlCf, 
MOOV, and Ql'IF pmak' comptinents), then the Create 
liutton will be active in the StandardFilePreview dialog. 

It .should Ix' noted that sound files preview in a little 
different way. The *pnot' componenl s crcaie an 
automatic KKsecond (if there’s that much sexmd) 
preview for supported sound file types without 
tieeding a ‘pnot' resource in the file. 


92 


Macintosh Q & A 


^ In MacTrch • August 1997 











You can reaci more about Preview Components in 
Inside Mac: Quic kTime Components. 

Q: When I drag from my application into a Finder 
window, the system crashes. I noticed Finder uses 
a windowKind value of 20 for its windf»ws, and so 
di>esmy app. When my app avoids windowKind 
20, everything’s hunky-dory. What gives? 

A; 'rhrOLigh the Drag Manager, Finder has gemen access to 
the windows in your app*s wimknv list (‘‘Specifically, by 
using undocLunenled calls to obtain the .scnirce window 
of a drag). If your window’s windowKind ftckl is 20, 
Finder assumes the window is one of its own (as 
opfxxsed to a driver window, wliose windowKind 
would be negative, or a dialog window, whose 
windowKind would lie 2, etej. I'inder grabs the value 
in the window's refCon field and type-casts it to a 
pointer to a C++ object in Finder's heap. 1 i hink you can 
sec where this is going: when Finder aiicnipLs to 
derefercnc'e the pointer, various crashing behaviors 
result. The upshot of this Finder hug is that your 
appliaition should not use windowKind values tjf 20. 

Q: I inslailed a sleep procedure. But the Power 
Manager will issue a sleepDemand if the user 
selects Sleep from the Special memi. The 
AukxSleepContro](false) call will stop sleepReqiiests 
but will it also stop SleepDemands? 

A; Your Application can (should) not refuse a sleepDentand, 
as documented in Inside Macineexsh: Devices pg 6-11: 
Wlien your sleep procedure receives a sleep demand, 
however, your prcx'edure has no way to determine 
whetlier it originated as a conditional sleep demand or an 
unconditional sleep demand. Your device driver or 
application must prepare for the sleep state and return 
control pn)mpily to the Power Manager when it receives 
a sleep deiiKind. As for AuLoSleepConrrol, please' refer to 
Inside Macintosh: Devices pg 6-44: ^licn enahleSleep is 
set to false, Jhe computer will not go into the sleep mcxlc 
tinJess it is forced it) either by .Sf)me user action — for 
example, by the user’s selecting Sleep from the Special 
menu of the Finder — or in a low l:>attery situation. 

Q; We are writitig an application that requires us to 
connect to a remote machine via TCP/IP and talk to 
a background application running on that 
macliine. However, wc canntit connect to that 
machine when it Is in sleep mode. Is there a way to 
keep the nctw€>rk services alive when a mactiine is 
in sleep mode? Tve seen how you can keep the 
serial port alive, but not tlie network services. 


A: When a Macintash (asually a FowerBook) goes into the 
“sleep'' state, it is incapable of resp>nding to network 
rerjuests — tlie connections actually sliul dt)wn. Tliere are 
some Macintexsh computers, however, that will attempt to 
go into an energy-efficient mcxle know as “doxe". 

'Fhe sleep state is easy to prc‘venl and i.s pretty well 
dcxaimenied in the Power Manager chapter of Inside 
Mac: Devices under ‘The Sleep Queue” and “Sleep 
PnKedures”, and there is iTX>rc information in TN 1046: 
Inside Macintosh: Devices - Power Manager Addenda. 

If you wanted to prevent tfie system frf>m sleeping or 
dozing, you would: 

1. Allocate a SleefjQKcc (preferably in lire system heap), 

2. Set it up to call into your slecpMandler. 

3. When the Mac anempes to sleep or doze, it will call your 
sleepHandler witli a sleepReriuest or dozeReque^t selector. 

4. 'ib prevent sleep from tx:curring, you simply return a 
nr^nzero value. 

In the doze state, OjKmTranspoit netwrirking is still 
enabled and TCP connections that arc set up sliould 
still function. But it might take several packets received 
within a short pcritxJ (try 10 per second) to wake the 
machine from its doze state. You miglu also ctmsider 
pinging the machine first to get it out of doze. 

Either way, you should lx: aware thal it will take st.>me 
time for the networking to reactivate, especially if virtual 
memory is enabled and the disk drive must spin up. 

Ihere is more infbrniation on controlling Lite Energy 
Manager tn 'FN 1086: Power Management ik Tlie 
Energy Saver API. 

Q: 1 can’t find documentation for the SetMovie- 
DefaultDataKef function. What does It do, and how 
do I use it? 

A: SctMovieDefault Data Ref is defined in Movies, h as: 
pa,scal OSErr ScaMovieDefaullDalaRefCMovie theMovie, 
Handle dataKefi OSType dataRefTy^jc); 

It allows you to contrr>i where data wall be written to 
when added to a movie. For example, if a movie was 
loaded from a File, the clehiult data reference is 
initialized io be the file from w^hich the movie was 
loaded. This example will set ilie default data reference 
to be a handle in memory: 

OSErr Conve e tGeneralHIDTToSoundtrack (void} 

I 

OSErr err noErr: 

Stands rdFileSeply tcply: 

short refNuiD: 

long loglcalEOF: 

Handle dataHandie - nil, tempHandle = nil: 
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Movie theMovie = nil* tempHovie nili 

// Spcdiy iht General MHit file to import 
StandardGetFllePrevlev (nil. 0. nil, treply)■ 
if (reply.sfGood) 

I 

// Open Uic data fori and suck ci’crythiog into a handle 
ere “ FSpOpenDF (Sreply.sfFile* fsRdPema* ^refNum): 
err =“ GetEOF (refNiim, AlogicalEOF): 

dataHandle ■ NevHandleClear ClogicalEOF): 

BLncK (dataHandle )i 

err - FSRend (refNum* klogicalEOF, ^dataHandle); 
KUnlock (dataHandle)r 
FSCloae (refHuiii): 

// Crrau: a new movie in memory^ sa its default data reference 
// to he a handle 

tempMovle “ HewMovie (newMovieActive): 
tempHandle = MewHandleClear (4): 
SetMovieDefaultDataRef (tempMovie, tempHandle* 
HandieDataHandlerSubType )i 
DispoaeUandle (teaipHandle ); 

H Paste the bandied data into our movie 
err = Fa^teHandlelntoMovio 

(dataHandle, 'Midi', tempHovie* 0, nil): 

// Save the mtnie out to a flattened Sic 

StandardPutFile [■■\pSave HIRl to^* ■'\pKlDI 
Bovie"* &repiy>: 
if (reply.sfGood) 

theMovie “ FlattenMovleData (tempHoviei 

flattenAddMovieloDataTork* &reply.sfFlle* 'TVOD*. 
tmCur re lit Script, cr eat eHovlePlleDe let eCur File); 

\ 

J 

return errj 


‘I'his meihotl works fine as long as you have enough 
memory, and don’t want to save the movie to disk. To 
put data into a file, call this function in order to pass 
in an alias to the file as the data reference and 
rAliasTyp^ tlaia reference type: 


SetMovieDefaultDataKef (tempMovie, fiteAlias, 
rAliaslype); 


Q: Wlien my application calls Trackl>rag, it crashes in 
low memory at an illegal instmctkin. The MacsBug 
stack crawl d<x;snT produce any useful information, 
(I tliliik llie errant code did a JMF to the bad 
iiistnictioii, as opposed to a JSR,) Tve stared and 
stared at all niy app's calls to the [>rag Manager and 
all the parameters appear to be valid. My drag 
tracking liaiidler is never called, incidentally. If I lake 
all calls tt> Drag Manager out of my applkatioii, it 
runs just fine, Tve been investigating this crash for 
two moiidis, Wliy is life so cruel? 


A: YouVe unearthed a really ugly problem. 

Early versions of Drag Manager did not enjoy the 
benefits of a drag-enabled Finder, so Drag Manager 
plays a little fast and loose with Finder's jump table. 
Yes, that means what it sounds like: Drag Manager 
calls Finder routines through its jump table. (It 
disgusted me at first, too.) 


The even more interesting story concerns the method by 
which Drag Manager decides your application is Finder, 
When TmckDmg is called* Drag Manager determines 
whether the drag originates in any of the windows in die 
window list of the cunrenL prtx:ess. If not, Drag Manager 
determines whctlier the drag originates in any Finder 
window* Since the desktop is a window for these 
purposes, there is a large area which qualifies. 

Once Drag Manager has decided the drag originates in 
a Finder window, it assumes that Finder is tlie current 
process. (This is the fatal mistake.) Once this 
assumption is in place, the next thing for Drag 
Manager to do in order to coax Finder into exhibiting 
the correct drag behavior is call an entry in whatever 
jump table can be found by offsetting the current 
value of register AS. This is a valid assumption if 
Finder is the c:urrenl process* which of course ir is not* 
This is where things go terribly astray: Drag Manager 
calls a jump table entry in your application drinking 
your app is Finder, your app*s routine doesn't do the 
.same thing as die Finder routine, and any numlx^r of 
spectacular effects can result. 

Now wait a minute* youTe thinking, die drag originated 
in one of my application’s wiiidows; how is dus stuff 
alxiut Finder relevant? Consider die event record your 
app is passing to Track Drag, An event record is 
supposed to contain u 'where' field expressed in globa! 
ctxxdinates. However, the 'where' field your app is 
passing is expressed in kxal c:(K)rdinaies, How? Wed* 
that depends on your application* liut often this can 
re.sult from ai>plication frameworks (like PowcrPlani, 
MacApp* or 'rillNK Class Libmry) modifying die event 
record liefore parsing it to your ccxle, Ihere's no 
language-level way to specify the record has lieen 
modified* so the compiler d(x*sn'l warn you, (Honestly, 
this Is Not Your Fault.) 

Your code blithely calls Track Drag with what it ought 
to be able to assume is a valid event record but is 
not. TrackDrag interprets tiie 'where' field, which Ls 
actually expressed in local coordinates, as glolral 
coordinates. This point is .somewhere up and to the 
left of where your application expects, and quite 
often It’s in the deskttjp* which as we said above is 
considered a Finder window for ihe.se purposes. 
Drag Manager reacts by going through its ritual for 
drags originating in Finder windows and eventually 
cra,shes after calling some txld routine in your 
application* as described above* 

To solve tliis problem, simply call UxralToGloliai on 
the 'where' field of The event record Ix^Tore calling 
TrackDrag. D 
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CodeWarrior 
Professional Release 1 

by Metrowerks 



More platforms, more languages, more options: CodeWarrior 
Professional Is designed to give you the tools you need for 
serious, industrial-strength programming. CodeWarrior 
Professional is the only Integrated Development Environment 
(IDE) in which you can edit, compile and debug C, C-n-, Pascal 
and Java programs for multiple target prxessors and operating 
systems. CodeWarrior's compilers produce fast, highly 
optimized code for Windows 95/NT running on x86, or Mac OS 
running on 68K or PowerPC processors. CodeWarrior 
Professional features the new CodeWarrior IDE Version 2. 

The newly revamped Project Manager supports multiple 


CodeWarrior for PalmPilot 

by Metrowerks 

CodeWarrior for PalmPilot is the first 
complete set of tools which enables you to 
develop for the U.S. Robotics PalmPilot connected organizer, tram 
the comtort of your PC or Macintosh computer. All the tools you 
need are included: the award-winning CodeWarrior IDE, compiler, 
linker, source-level debugger, GUI builder, and other tools, plus 
online documentation and reference materials. Includes one year of 
product updates and tree technical support. 

(SCVIff’ALM) Our Price $369 
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CodeWarrior 
for BeOS 3 

by Metrowerks 


Be 

OS 


• Start programming for the new, innovaBve Be Operating 
System (BeOS) with complete set of Codewarrior tools 

• BeOS-native Integrated Development Environment (lOE) with 
all the familiar CodeWarrior features at your fingertips 

• A BeOS PowerPC compiler and linker, an editor w/syntax 
color and styling, and a source-level debugger 

• BeOS header and libraries, complete documentation, useful 
C-h-f classes, and sample code 

• The Be Operating System Advanced Access Preview Release 
allows you to run and program for the BeOS on a 603 or 604 
PCI based PowerMac 

(SCWFB) 0urPrice$149 


projects open simultaneously, multiple targets per project, and 
threaded execution, plus it's significantly faster. CodeWardor 
Professional also includes online books, documentation, and 
reference materials, as well as tutorials and sample code. We 
support your development efforts with one free update and free 
wodd-class technical support tor a year with registration. 

• includes Windows 95/NT and Mac OS versions 
of the CodeWarrior IDE 

■ Supports C, C-t-t-, Pascal and Java 

• Develop for Windows 95/HT on x86 and Mac OS on 
68K/PowerPC from either version 

• New Project Manager supports muffipie open projects, 
subprojects, multiple targets per project, and threaded execution 

• Integration of tools means you spend less time navigating and 
more time coding 

(SCWPRO) Our Price $599 

Upgrade for competitive product owners 
(SCWPRUP) Our Price $449 




CodeWarrior Latitude ' ^ i | 

by Metrowerks “ 

Don't throw away the investment you 
have made in your Mac OS applications! 

With the DR/1 release of CodeWarrior 
Latitude, you can prepare your 
Macintosh applications to run native under Silicon Graphics IRIX 
or Sun Solaris (and soon, Rhapsody). Begin work now to 
prepare your Mac OS application to run native under Rhapsody. 
By compiling and linking your CodeWamor project with the 
Latitude libraries, you can identily which portions of your code 
will port smoothly and which Mac Toolbox traps are not 
implemented. Additionally, you can expand the market for your 
Mac OS application by completely porting it to Silicon Graphics 
IRIX or Sun Solaris at a fraction of the cost of other porting tools. 
As the Rhapsody API evolves, so will Latitude. Registered users 
of CodeWarrior Latitude will receive all developer releases, the 
first full release, plus one additional product update, to ensure 
that you have access to the most up-to-date Rhapsody porting 
tools available. 

(SCWLAT) Our Price $399 


CodeManager 4 

by Metrowerks 

• Source code control system, plug-in to 
the CodeWarrior IDE 

■ Compatible with Microsoft Visual 
SourceSafe version 5.0 

• Cross-platform support (Mac, 

Windows. UNIX. OS/2) 

• Configuration management in excess of 4 billion files 

• Over 8,000 files and sub-projects in a single sub-project 

• Registered users receive one year of free technical support and 
two free updates 

(SCDMGR) Our Price $399 
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Discover Programming 
with Java 

by Metrower1<s 

Discover Programming with Java is a 
professional Java environment, 
providing the most complete toolset 
available on the Macintosh. All your 
projects can be built from the ground 
up with the award-winning 
CodeWarrior Integrated Development 
Environment (IDE), which boasts a fult-featured editor, a Sun- 
validated Java compiler, a source-level debugger and a Java class 
browser. Preview your Java programs using the applet viewer, which 
is conveniently linked to the debugger for easy testing. 

• Full Java toolWt; project manager, linker, editor, class browser, 
source-level debugger, applet viewer and more 

• Includes an online book, plus online documentation, reference 
materials and tutorials 

• One year free technical support with registration 
(SCWDISCJAVA) Our Price $79 



Newton Toolkit 1.e 

by Apple Computer, Inc. 



With Newton Toolkit, you can easily create software that runs on any 
Newton PDA, including Apple’s MessagePad and Motorola’s Marco, 

• Now supports Newton 2.0 

• Dynamic Language Eases Development 

• Allows you develop applications interactively 

• New Compiler Enables Faster Applications 
Newton Toolkit 1.6 
(SNETO) OurPnce $149 
Newton Toolkit Update 1.6 
(SNETOUP) Our Price $29 
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Apple Dylan 


Apple Dylan Technology Release 

by Apple Computer, Inc. 

• Contains a PowerPC-native prototype version of a development 
environment based on the Object Oriented Dynamic Language 
(OODL) Dylan. Developers will be able to produce code targeting 
both 680x0 and Power Macintosh systems 

• Automatic memory management 

• Application framework and user-interface 
S( builder 

• High-level exception handling 

• Cross-language support for C code and APIs 

CD & Online Documentation 
(SADTRO) Our Price $39.95 
CD & Hardcopy 

(SADTRH) Our Price $59.95 


Discover Programming 
for Macintosh 

by Metrowerks 

Discover Programming for Macintosh 
provides everything you need to start 
and complete your programming 
education. Full-featured, award-winning 
CodeWarrior tools allow you to build 
full-blown 68K Macintosh applications. 
Powerful reference material and online 
books, including Learn C on the Macintosh, Learn C-t-+ on the 
Macintosh by Dave Mark, and Jim Trudeau’s Programming Starter 
Kit for Macintosh are Included on the CD-ROM. Pius, the book 
examples have been converted to Apple Guide files for help that is 
just a mouse-click away. Loads of source code is also included to 
help gel you started on the road to success. 

• CodeWarrior Integrated Development Environment (IDE) with C, 
C-H-, and Object Pascal compilers for 68K Mac OS 

• Includes four online books, plus online documentation, reference 
materials and tutorials 

• One year free technical support with registration 
(SCWDISCMAC) Our Price $79 


Newton Toolkit 1.6 for Windows 

by Apple Computer, Inc. 

With Newton Toolkit, you can easily create software that runs on 

any Newton OS device from Apple or its licensees, The Newton 

Toolkit is a development environment that reduces the complexity 

and time involved in creating great software products. 

• Provides access to features specific to the Newton 2.0 OS - Allows 
developers to create new or modify existing Newton applications to 
take advantage of powerful Newton 2.0 OS features 

• Supports Windows 95, Windows NT 3,5x, and Windows 3.1 (with 
Win32s) operating systems -Enables developers to use multiple 
development environments/operating systems when creating 
Newton applications 

• Includes Macintosh-to-Windows NTK project converter tool - 
Allows developers to automate conversion of existing NTK projects 
from Macintosh platform to Windows platform 

• Provides NS Debug Tools - Allows developers access to interactive 
Newton application debugging tools. Offers extended NewtonScript 
debugging functions, which let developers study and manipulate 
an application running on a Newton device. Developers can use 
NS Debug Tools to set break points in an application after it's been 
compiled and installed, step through program execution, examine 
and change objects on the Nevrton, and display a textual 
representation of the interpreter instructions 

(SNETOW) 0urPrice$149 
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MkUnux: Microkernel 


Linux 

for the Power Macintosh 

by Prime Time Freeware 
MkUnux is a native port of Mach 3 and 


the Linux 2.0 kernei, compiemented by hundreds of commands 
from BSD, GNU, and X11. it runs on most (NuBus abd OCU bus) 
Power Macintosh systems; Pertorma, PowerBook, and 
multiprocessor ports are currently under development. 

MkUnux is robust, powerful, freely distributable, and source code 
compatible with most other Unux systems. It provides a full suite 
of development tools, support for AppleTalk, HFS, and Objective- 
C, and access to a vast amount of free software. MkUnux Is a 
great way to "come up to speed" on Mach, UNIX, and Rhapsody. 

• MkUnux user community supports FTP and web servers, 
development and porting efforts, and several mailing lists 

• The Apple sponsored reference retease contains a wealth of 
introductory and reference material on Unux, Mach, NeXT, and 
the Power Macintosh 

• Includes free 3.0 upgrade 
(BMKLINUX) Our Price $50 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Pro Fortran 

by Absoft Corporation 

Absoft Pro Fortran combines native F90. VAX compatible F77, and 
C/C++ compilers into a single, easy to use environment. All compilers 
are link compatible and operate through a common interface. 

• Graphical debugger, browsers, array display, performance profiler, 
linker, MRWE application mainframe 

• MIG graphics library. Absoft Create Make, several utilities, the 
latest version of MPW and illustrated documentation 

• Whole array operations, modules, interface blocks, and user- 
defined types or data structures 

• Dynamic memory allocation and new control constructs 

• F90 is link compatibie with Absoft F77, C++, MrC and 
CodeWarrior 

• It is fully compatible with Toolbox, MPW tools, and most third- 
party products 

(SAPROF) Our Price $899 

Order Toll-free 
800-MACDIV-1 


VIP-BASIC: 

Visual Interactive 
Programming in BASIC 

by Mainstay 

Now you can create fult-fealured. stand-alone 

Macintosh and Power Macintosh applications in standard BASIC code! 

VIP-BASIC 2.0 is the fastest way to program your Macintosh. 

• Rapid application development environment with application 
framework, mix and match: VIP-BASlC high-level subprograms 

• Import pre-existing BASIC code; automatically integrate BASIC 
code, export C Code for compiling: automatically convert your 
BASIC code to C for compilation with Metrowerks’ CodeWarrior 
(SVIPBASIC) Our Price $195 


Macintosh Common Usp 4.0 

by Digitool, Inc. 

Macintosh Common Usp provides users 
with a rich set of object-oriented dynamic 
language features making it especially 
well-suited for rapid prototyping, custom 
development for business and education, 
scientific and engineering applications, and academic research. 

• Power PC native environment & compiler, full Macintosh support 


VIP-C: 

Visual Interactive 
Programming in C 

by Mainstay 

Now you can create full-featured, stand¬ 
alone Macintosh and Power Macintosh applications in just minutes. 
VIP-C 2.0 is the first rapid application development system for 
creating complete Macintosh programs in standard ANSI C. 

• Includes powerful, tightly integrated visual debugger. Import pre¬ 
existing C code: automaticaily integrate C code with a current project 

• Includes full-featured mini database; (ltd to 32K) of the powerful 
VIP-BASIC database manager gives you everything you need to 
setup royalty-free, multhuser database applications 

(SVIPC) Our Price $295 


• CLOS, the standard Common Usp object system 

• Interactive dynamic environment, multiple prxesses 

• Automatic memory management and self-typing data 

• Ephemeral garbage collector, smaller application footprint 

• Compiies writh Common Usp industry standard and smart 
programmabie tools, 110+ mb of user contributed code 

• Complete on-line documentation (manual sold separately) 

• Software license and regisVation card 
(SMCUSP) Our Price $675 
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ObjectMaster 
Professional Edition 

by Altura Software, Inc. 



Object Master is an innovative programming environment that 
provides all the necessary tools to write, organize, and navigate 
through source code, 

• Write code using the most robust source code editor available 
on the desktop 

• Organize source code into projects to quickly access and 
manipulate all files 

• Navigate through source code using intuitive graphical 
Browser windows 

(SOMPE) Our Price $399 


Roaster 

by Roaster Technologies, Inc. 

Roaster Release 3,1 is now available 

with JDK 1.1 and JavaBean support! 

Getttie most out of Sun's Java'^'^ 

programming language with this 

powerful development environment. 

• Features include: ability to build 
stand-alone Macintosh applications 
or applets; visual interface builder; ability to create cross-platform 
zip files; powerful Java debugger; wizard for quickly creating Java 
applets or applications; JavaBean support; JDBC support; Java 
object database included; ability to call AppleScripts from Java; 
Just-in-time (JIT) compiler; JDK 1.1 ,x support; class tree and 
hierarchical class browser; much more! 

• Software includes; Over 300 example applets and applicatipns; 
Netscape Internet Foundation Classes; Object Design's PSE for 
Java; OpenLink Software's JDBC Drivers; OpenSpace Java Generic 
Library; Microline Component Toolkit Lite 3,0; much more! 

• Requirements: Runs on 68k or PowerPC, CO-ROM 

• Price includes all web-based updates 
(SR0AST3) Our Price $99 




NS BASIC 3.6 
for the Newton with 
Visual Designer 

by NS BASIC Corporation 

• A fully interactive implementation 
of BASIC programming language 

• Runs entirely on the Newton - no 
host is required 

• Create files, access the built in soups, and the serial port for 
Input and output 

• Work directly on the Newton, or through a connected Mac/PC 
and keyboard 

• Get the BASIC Internet Tool, available at no charge to NS BASIC users 
from wvwir.nsbasic.com 

• Release Notes with sample code are available from the same location 

• Runs on any Newton MessagePad 130 with NS BASIC and the 
Newton Internet Enabler. Also runs on MP 1201s with NOS 2.0 that 
have full memory available 

• Write short programs to access News, mail and the web 


(SNSBASIC) Our Price $99 



’'TENON 

INTERSYSTEMS 


CodeBuiider 

by Tenon Intersystems 

CodeBuiider is a powerful and unique Macintosh software 
development tool for porting existing apps or developing new, 
advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C-i-+, 
Objective-C, Java, Ada, and Fortran development tools 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C-i-h, Ada 95 and Fortran 77 

• Web S internet scripting tools: Perl, MacPeri, tcl/tk, bash, sh, and csh 

• Supports Rhapsody kernel APIs and Rhapsody TCP sockets 
(SMIOCODEB) 0urPrice$149 



Here’s a list of all available products. For full product descriptions 
please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

LPA MacProlog Developers Edition 

SLPAD 

995.00 

LPA MacProlog Programmers Edition 

SLPAP 

495.00 

LS Fortran Pro 

SLSFORT 

595.00 

LS Fortran Plug-In 

SLSFPI 

199.00 

Mac FORTRAN II 

SF0RT2 

595.00 

Power MachTen-UNiX 

SM10PPC 

695.00 

Presenting Magic Cap 

BPRESMAGIC 

15.25 

SmalltalkAgents 

SSTA 

695.00 

Think Pascal 4.0 

SPASCAL 

165.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C++ classes for integrating 
Internet e-mail in your applications 

• Helps you write software that 
can share mail with other leading 
e-mail products 

• Ftoyalty-free MIME, SMTP, and 
POP3 APIs 

Gives you the most robust MIME parser and encoder available 
Ideal for use in Internet and Intranet environments 
Comes complete with samples with documented, reusable 
source code 

Free standard technical support 
(SOSMSDK) Our Price $495 


r-tree Report Generator 

by Faircom 

Handles virtually every aspect of report 
generation; 

• Complete C source 

• Complex multi-line reports 

• Multi-file access 

• Complete layout control 

• Conditional page breaks 

• Nested Headers and Footers 

• Horaontal Repeats 
(SRTRG) Our Price $445 


Spellswell Plus 2.1 

by Working Software 

• Award-winning, comprehensive, practical spelling checker that 
works in batch mode or within applications that incorporate the 
Apple Events Word Services protocol {e.g., Eiidora, WordPerfect, 
Communicate!, and InfoDepot} 

• Checks for spelling errors as well as common typos like 
capitalization errors, spaces before punctuation, double word 
errors, abbreviation errors, a/an before vowel/consonant, etc. 

• MacTech orders include developer kit wifii Writeswell Jr., a sample 
AppleEvents Word Services word-processor and its source code 

• Available for OEM Sales 
(SSPELL) Our Price $49 


c-tree Plus® Database Handler 

by Faircom 

Unsurpassed Cross Platform 
Tools for Mac Developers! 

• Full C Source 

• Client/server Option 

• Over 16 years proven 
reliability 


FairCofn' Server 


DUMB 

TB^I 



D0S/Wtn95 


Concurrent simultaneous access of Mac/PC files 
Superior throughput and performance 
Unparalleled scalability and flexibility 
Fixed/Variable length files 
(SCTPDH) Our Price $895 


Memory Mine 

by Adianta Inc. 

• Monitor heaps, identify 
problems such as 
memory leaks, and 
stress test applications 

• Active status of 
memory in a heap is 
sampled on the fly: 
allocation in non- 
relocatable (Ptrl, 
relocatable (Handle) and 
free space is shown, as are heap corruption, fragmentation, 
and more 

• Allocate, Purge, Compact, and Zap memory lets users stress test 
all or part of a program 
(SMEMMINE) Our Price $99 


ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that for the first time, allows you 
to deliver and run AppleScripts from Web pages. The ScriptDemon 
plug-in will execute the embedded AppleScript code included on a 
Web page. ScriptDemon painlessly and inexpensively handles many 
previously impossible tasks, such as: 

• Using the Intranet to manage all Macintosh computers on-line 

• Using the Internet to install and configure software 

• Using the Internet to configure hardware 

• Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
Internet and Intranet 

• A perfect companion to LiveCard! 

(SSDEMON) Our Price $949 




Guide Composer'" 1.2 

by StepUp Software 


STEP"' i 

SOFTWARE I 


• Create powerful Apple Guide help systems for any new or existing 
Macintosh application 

• Provides a WYSIWYG development environment: Guide content is 
developed in Guide windows 

• Design topics, phrases, and panels in the same format as the user 
will use them 

• Features are WYSIWYG interface. Topics, phrases, and 
hierarchical phrases. Coach marks, Fully-Integrated with Apple’s 
Guide Maker (distributed virith Guide Composer), compiles scripts 
automafically. PICTs in Panels, Generated Guide scripts are modifiable 

• FREE Update to all registered Guide Composer users. Demo is 
available at http;//www.guideworks.conn/ 

(SGCOMP) Our Price $99 

SEE RELATED PRODUCTS: AppleGiiide Complete, Danny Goodman's 

AppIeGuide Starter Kit, Real World AppleGuide 
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VOODOO 1.8 

by UNI SOFTWARE PLUS 

• Stand-alone version 
control tool tor all sorts 
of projects (software 
development, 
documentation, design. CAD, publishing, etc.) 

• Smooth integration witi Metrowerks CodeWarrior IDE 

• Simple and clear management of variants and revisions of entire 
projects (not only of single files) 

• Easy-to-use graphical project browser gives access to all versions 
that were ever stored. 

• Recording of the complete history (who made which changes 
when and why) 

• View differences between versions (not only for text files!) 

• Efficient delta storage of arbitrary files (text as well as non-text 
files) gains savings of 95 % and more 

• Administration of users with hierarchical access rights 

• Configurable local file locking (Finder flag or ‘ckid’ resource) 

• Scriptable, essential parts PowerPC native 
Single license (SVOOD001) $229 

2 pack (SV00D002) $359 
5pack(SV00D005) $799 
1Opack(SVOODOO10) $1369 
20pack(SV00DO020) $2399 

Additional pricing available on request. 

SEE RELATED CATEGORY: Dev. Environments 



StoneTable 68K/PPC 

by StoneTablet Publishing 

StoneTable is a powerful and professional replacement for the List 
Manager used by developers woddwide. Version 3.0 is a new 
release with many improvements including better clipboard and 
drag/drop integration with other applications. 

• Available for use with CodeWarrior C & Pascal 

• Includes libraries for 68K {A4 & A5) and PowerPC 

• An LTable-like class is provided to incorporate StoneTable into 
the PowerPlant environment 

(SSTONEFAT) Our Price $199 

QC 

by Onyx Technology, Inc. 

High performance runtime stress 
testing for applications. 

• Tests include heap checks, 
purges, scrambles, 
handle/pointer validation, 
dispose/release checks, write to 
zero, de-reference zero as well 
as other tests like free memory 
invalidation and block bounds checking 

• Extremely user friendly - ideal for non programmer testers 

• Also available in Japanese 
(SQC) Our Price $99 



Spotlight 

by Onyx Technology, Inc. 


SPOTLIQhT 



spotlight is a stand alone debugging aid that perforrns memory 
protection (arrays, heap accesses, outside your heap, low mem, 
etc), discipline checking on toolbox calls, and leaks detection. 

• Spotlight is sold on an annual subscription basis 

• The subscription service provides all updates 

• Includes maintenance releases for one year after 
the initial purchase or renewal date. 


(SSPTLT) Our Price $199 


AppSketcher 1.0 
for BeOS 

by SeatWare, Inc. 

App^etcher is the premier 
programming tool for the BeOS. 

• The fastest way to develop software on the BeOS 

• Drag and drop design is great for creating user interfaces 

• Supports localization for worldwide sales 

• Expands applications easily without manual code 
modifications 

• Shortens development time by automating the Make process 
through direct communication with the BelDE 

(SASFB) Our Price $199 
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MacA&D 8.0 

by Excel Software 

• Structured analysis and design 

• Object-oriented analysis and design 

• Real-time and multi-task design 

• Data and screen modeling 

• Integrated code editing and browsing 

• Multi-user dictionary and requirements 

• Code to design diagrams for C. 
C-f+.etc. 

• Design diagrams to code for C, 

C-r-i-, etc. 

• State modeling diagrams and tables 

• Use cases with traceability 
(SMACADP) Our Price $1995 


Apprentice 6 

by Celestin Company 



Apprentice 6 is a high-quality CD-ROM collection of over 600 
megabytes of up-fo-dafe source code, utilities, and info for Mac 
programmers. All of the source code and utilities are completely 
new or updated for this retease. 

• Frontier 4.1, the highiy-acclaimed scripting environment 

• More PowerPlant AND many more PowerPC samples 

• Cool new languages and environments added (Clean, Eiffel, F, 
Tcl-Tk) 

• Mot new demos from leading Mac development companies 
(SAPPRENT6) Our Price $35 
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SoftPolish CD-ROM 

by Bare Bones Software 

• The essential tool for software 
quality assurance on the 
Macintosh 

• Helps you identify 
inconsistendes with Apple's user 
interlace guidelines, misspelled 
words, missing resources, and 
other mistakes 

■ Provides tools to put the finishing touches on software distribution 
packages prior to release 

• Works independently of any programming language or environment 

• Ideal for sanity checking software throughout the develt^ment process 
(SSORPOL) Our price $99 



AppMaker 

by towers Development 

• Develop the user interface for a 
Macintosh application using the 
original interface builder 

• Just point and click to design 
your application 

• Creates resources and generates 
excellent source code 

• Supports most development 
environments including Metrowerks, Symantec, or MPW; C, 
C++, or Pascal; procedural or object-oriented, using 
PowerPlat>t, TCL, or MacApp 

• The generated code uses the Universal Headers to provide 
PowerMac compatibility 

• Great tool for beginners to learn object-oriented and 
Macintosh Toolbox programming techniques 

• Includes one-year subscription on CD and hardcopy 
documentation 

(SAPPMAKE) Our Price $299 



B-Tk-ee HELPER 2.2 

by Magreeable Software 

• inexpensive database engine 
for Macintosh programmers 
in C source code 

• Uses contiguous fixed length 
blocks 

• Expands the file as necessary and contracts files when 
possible 

• Inserts and deletes keys in one or more B-Trees 

• Finds keys equal to, less than, or greater than a given value 
In a tew hundredths of a second 

• Finds lists of records whose keys are equal to, less than, or 
greater than a given value or are in a range of values 
(SBTREE) Our Price $149 



Future Basic II 

by Staz Software 

FutureBASIC II is the award winning 
leader in Macintosh BASIC 
programming. 

• Source level debugger and Interactive compiler/editor 

• Multi-file Project manager and Multi-file find and replace 

• Super fast compilation. 32 bit clean, and System 7.x savvy 

• QuickBASIC converter 

• Getting Started manual with over 500 example files 

• Full support of standard B/^IC 
(SFBAStC2) Our Price $229 




• T(ue relational database system for Apple Macintosh computers 

• Provides a powerful choice for ctevetopens who want to create 
database centered ai^ications with no performance trade-offs 

• Features SQL, full transacfion control, error recovery, single user, 
client server architecture and multi-platform support including 
DOS. Windows. OS/2 and UNIX 

• The C/C++ API is identical and fully portable across all supported 
platforms 

• Third-party vendors supporting dtf will be able to offer a variety of 
advanced features and benefits to their customers royalty free 

• Tools are included for importing, exporting, creating and managing 
databases and users 

• Supported development environments include: Symantec, MPW, 
Metrowerks and more Mac/SOK 

(SOTF) Our Price $695 


Step-Up Installer Pack 

by StepUp Software 

• Package of several Installer "atoms" that let developers incorporate 
graphics, sounds, file compression and custom folder icons Into 
installation scripts 

• Compression formats supported are Compact Pro & Diamond 

• Each atom also available separately 

• Compression requires additional licensing 
(SINSTALL) Our Price $219 

ScriptGen Pro 

by StepUp Software 

• Installer script generator which requires no programming or 
knowledge of Rez 

• Supports StepUp’s InstalleiPack, Stuttit decompression, Compact 
Pro decompression, custom packages, splash screens, network 
installs, and resource installation 

(SSCRPTGEN) Our Price $169 
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Water's Edge Software 



Tools Plus libraries + frameworic 

by Water’s Edge Software 

Easily create compact, fast running, professional looking applications and 
plug ins*. Toots Plus lets you create wirtually any user interface element 
with a single routine, and it transparently provides a robust infrastructure 
to make all your pieces work together as an application. Rated 4 stars by 
Macworld! MacTech (July 96); "it's an incredibly rich collection of tools... 
If you are interested in developing applications that have 'quality' written 
all over them, then Tools Plus is for you.” 

• Simplifies programming and thins source code 

• Automates all standard GUI elements 

• Thousands of extras, from floating palettes and tool bars to 
powerful picture buttons 

• Includes numerous 3D grayscale options 

• Over 1/2 MB of custom fonts, icons, cursors, and other resources 

• Includes SuperCDEFs world-class conbols (an $89 value) free 
(STOOLCW) Our Price $249 

CodeWarrior Gold {C/C++ & Pascal. 68K & PPG) 

(STOOLCWB) Our Price $199 
CodeWarrior Bronze (C/C++ & Pascal, 68K) 

(STOOLSYMT) Our Price $199 

Symantec (THINK) C/C++ and THINK Pascal (68K) 

(STOOLSYM) 0urPrice$149 
Symantec (THINK) C/C++ (68K) 

(STOOLPAS) Our Price $149 
THINK Pascal (68K) 

‘CodeWarrior required to write plug-ins 



Order Toll'lree 
SOO-MACDEV*] 


(eootfZ'iisij 


TestTrack-Bug Ikacking the Macintosh Way 

by Seapine Software, Inc. 


• Tracks bugs, feature requests, test configurations, users, and more 

• Includes notifications, security, a powerful filter mechanism, and 
multiple reports 

• Links your testers, engineers, documentations staff, and project 
managers together to ensure all bugs are identified, fixed, and 
documented 

• Eliminates the need to build custom bug tracking solutions using 
general purpose database tools 

• Supports single- and multi-user bug dat^ases (additional licenses 
required to use multi-user features) 

(STETR) 0urPrice$129 


CodeBuilder ’^TENON 

by Tenon Intersystems tNiEnsvsiEMs 

CodeBuilder is a powerful and unique Macintosh software 

development tool tor porting existing apps or developitrg new, 

advanced applications on Power Macs and Power Mac clones. 

• A powerful Macintosh software development tool suite of C, C++, 
Objective-C, Java, Ada, and Fortran development tools. 

• Complete UNIX & X development environment for developing UNIX 
or Macintosh apps 

• Includes compilers and source-code debugger for Objective C, and 
C, C++. Ada 95 and Fortran 77 

• Web & internet scripting tools: Perl. MacPerl, tcl/tk, bash, sh, 
andcsh 

• Supports Rhapsody kerne! APIs and Rhapsody TCP sockets 
(SMIOCODEB) Our Price $149 

Phyla™: Object-Oriented 
Database 

^ •Powerful Databases Without 

einHUL ^ Programming: Phyla handles your all 

your complex database needs 
•Define a Database in Minutes: Using 
an intuitive, graphical user interface 
• Objects Are a More Natural /Approach; 
Phyla creates real world databases 

• Drag-and-Drop Ease: Relate objects by simply dragging objects 
between windows 

• Create Custom Forms and Reports: Quickly create custom forms 
and reports 

• Fast Finds and Sorts: Perform complex queries and calculations 
without programming 

• Synchronize Multiple Databases Copies 

• Password Protection With Access LinHlations 

• Easy Import and Export Import from other databases, export data 
in various formats 

(SPHYU) Our Price $179 


BBEdit 4.0.4 

by Bare Bones Software 

A powerful, easy-to-learn text 
editor. Adds new features for 
HTML coders, including a 
spelling checker and HTML tag 
palette. Accelerated for Power 
Macintosh; dragging supported everywhere; Internet Config 
aware; PowerTalk aware. Integrated support for Symantec's 
IDE. Metrowerks CodeWarrior, THINK Reference 2.x, MPW 
ToolServer, and most other environments. Many UNIX style 
tools, including ‘grep’ searches, file comparisons, and sorting 
multi-file search and replace. PopUpFuncs feature lets you 
Jump to a function from a menu. 

(SBBEDIT) Our Price $119 



Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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SEE RELATED PRODUCTS: 
Development Environments 


CPU Doubler 

by Orchard Software 

• Performance enhancement utility 
tor the Macintosh 

• Increases the speed of your 
computer by 100% 

• Works on both the PowerPC and 
68K Macintosh 

• Manages computer throughput 
using a proprietary scheduling 
algorithm 

• Ensure optimal performance and 
compatibility 

(SCPU2X) Our Price $79 


Compilelt! 

by Royal Software, Inc. 

Compilelt!, the first HyperTalk compiler, is a complete developement 
system for the creation of XCMOs and XFCNs, 

• Expand the capabilities of your environment by using Compilelt! 
and the ROM Toolbox extensions 

• Increase the speed of routines written in HyperTalk by turning 
scripts into externals 

• Protect sensative code from prying eyes because your code is 
now compiled! 

• Easily learn Macintosh programming by exploring the ROM 
Toolbox 

• Includes Debugit!, a valuable source-level debugger for externals 
created with Compilelt! 

(SCOMPIT) Our Price $149 



DesignWorlcs 4.0 

by Capilano Computing 

DesignWorks 4.0 has all the ease 
of use and schematic editing 
power of previous versions, plus 
new features designed to make 
your entire design process easier 
and more error free. The 4.0 
version has new menu customization and scripting features that will 
directly address your design checking and interfacing needs. 

• Flexible schematic editing features speed the drawing process 

• Full Undo/Redo on all editing operations 

• Hierarchical design with unlimited levels is fully supported 

• Powerful attribute features allow arbitrary text information to be 
associated with any signal, device or device pin 

• Extensive symbol libraries with over 12,000 parts in ANSI and 
IEEE format 

• Integrated device symbol editor allows you to create custom 
symbols using standard drawing tools 

• Interactive digital simutator option is available. No netlists, no 
application switching! 

(SDWORKS) Our Price $995 




EtherPeek ??***”' 

by AG Group, Inc. 

EtherPeek for Macintosh is a full-featured 
protocol analyzer that allows you to quickly 
and easily test and debug network communication, and: 

• Check for protocol compliance 

• Use hundreds of built-in decodes 

• Develop custom packet decoders 

• Filter packete during or after capture 

• Test device reactions to specific packet types 

• Customize or alter packets for transmission 

• Generate traffic to test varying loads 
(SEPEEK) Our Price $745 


OpenGL for 
the Macintosh 

by Conix Graphics 




OpenGL is the premier 30 graphics library that allows software 
developers the ability to develop high-quality, interactive 2D and 3D 
graphics applications. OpenGL can perform the following wide range of 
functions which will enhance the devel(X)ment of all graphics software: 

• Geometric primitives (points, lines, and polygons) 

• RGBA or color index mode 

• Viewing and modeling transformations 

• Texture Mapping, Lighting, Shading and Z Buffering 

• Atmospheric Eflecls (fog, smoke, and haze) 

• Alpha Blending (transparency) 

• Antialiasing, Accumulation Buffer, Stencil Planes 

• Display list or immediate mode 

• Polynomial Evaluators (to support Non-uniform rational B-spllnes) 

• Feedback, Selection, and Pictdng Raster primitives (bitmaps and 
pixel rectangles) 

• Pixel Operations (storing, transforming, mapping, zooming) 
(SOPENGL) Our Price $389 


VText 

by VIvistar 

VText is a C-t-t- add-on library for 
Metrowerks' Powerf^ianl application 
framework. VText provides complete 
Macintosh text support including: greater 
than 32kb text, undo, drag and drop editing, 
AppleEvenI scripting and recordability, full 
support for multibyte characters and inline 
input methods including Japanese and Chinese text, and full support 
for bi-directional script systems including Arabic and Hebrew. 

• Full featured text engine for Metrowerks' PowerPlant 

• Stylesets and rulersets with tabs 

• Flexible object oriented C-i-f API 

• Full undo and drag and drop editing 

• ViforldScript savvy including bidirectional and multibyte scripts with 
inline editing 

• AppleEvent factored for scriptabiiity and recordability 
(SVTEXTl Our Price $349 
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QUED/M 3.0 

by Nisus Software 

• The programmer's text editor that defined the 
industry standard tor speed and efficiency 

• PowerPC native 

• Features integrated support for Symantec 
C/C++, Metrowerks CorteWarrior 6. and MPW 

• Supports all the major development environments on the Macintosh. 

• Powerful editing features, including unlimited undo and redo, macro 
language, scripting, lexl folding, ton editable/appendable clipboards, 
markers, displaying text as ASCII codes, dynamic coloring of C/C++ 
keywords/comments, rectangular and non-contiguous selection 

• Includes Celestin Company’s APPREIWCE 4 
(SQUEDM) Our Price $89 


A6 Author 

by Lakewood Software 

AG Author 1.0 is a full-featured Apple Guide authoring tool with 
fully customizable project template. The following features are 
unique to AG Author; 

• Support for styled, colored. & hot text 

• Fully customizable project template 

• Flexible compile options 

• Find & replace tool for scripts 

• Multiple open projects 

• Rapid deployment of project globals 
(SAGA) Our Price $99 

SEE REIATED PRODUCTS: AppleGuide Complete. Danny Goodman’s 
AppleGuide Starter Kit, Real World AppleGuide 
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Bee-one 

by Power Box 

Bee-one lightens your load on the road by 
adapting relational databases developed 
under 40” to the Newton Platform. Once 
the program is installed on both the 
Macintosh and the Newton, it takes 4 
simple steps to use Bee-one! 



' Database transfer. Set-up, Use, and Synchronization 
(SBEEONE) Our Price $139 





Web Ware 

by BeactiWare, Inc. 

The ultimate collection of clip media and templates 
for building your own Web Page. An incredible 
selection of Shockwave movies, animated GIFs, 
butktos, bullets, dividers, and sample FtTML pages. 
There are literally thousands of graphical elements on this disc, all there 
to spice up your web page. In all, it's about 300 megabytes of creativity 
only a mouse-click away! System Requirements: PC - 486 or better with 
8 MB RAM, Sound card, SuperVGA, CD-ROM drive. Macintosh - Color 
Mac with 8 MB RAM, CD-ROM drive. 

(SWEBW) Our Price $24 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Fortran 77 SDK 

SF77 

699.00 

ICONIX PowerTools-IO Pack 

SICPP10 

7,845.00 

ICONIX PowerTools-6 Pack 

SICPP6 

5,945.00 

ICONIX PowerTools-8 Pack 

SICPP8 

6,945.00 

ICONIX PowerTools-AdaFlow 

SICADA 

1,395.00 

ICONIX PowerTools-ASCII Bridge 

SICASCII 

1,395.00 

ICONIX PowerTools-CoCoPro 

SICCOCO 

1,395.00 

ICONIX PowerToots-DataModeler 

SICDATAMOD 

1,395.00 

ICONIX PowerTools-FastTask 

SICFASHASK 

1,395.00 

ICONIX PowerTools-FreeRow 

SiCFREEFL 

1,395.00 

ICONIX PowerTools-Object Modeler 

SICOBJMOD 

1,395.00 

ICONIX PowerTools-PowerPDL 

SICPOWER 

1,395.00 

ICONIX PowerTools-QuickChart 

SICQUICKCH 

1,395.00 

ICONIX PowerTools-SmartChart 

SICSMART 

1,395.00 

ICONIX Training & Consulting 

TICONIX 

2,945.00 

IMSl Math and Stat Library 

SIMSLSTAT 

495.00 

Info-Mac X 

SINF0MAC10 

39.95 

Ionizer Real-Time Spectral Reshaping Tool 

SIONIZER 

800.00 

LiveAccess™ 1 User Edition 

SLAUE 

69.00 

Live/tocess™ 1 Developer Edition 

SLADE 

99.00 

LiveCard 

SLCARD 

149.00 

LJ Profiler 

SLJPROF 

295.00 

MacFlow’”: Flowchart Design and Development 

SMACFLO 

179.00 

Mac Source II 

SMACSOURCE 

29.95 

Nisus Writer 5.0 

SNtSUSW 

220.00 

Plan & Track™: Project Planning and Management SPLNTRK 

179.00 

Screen Machine 

SSM 

24.00 

Spyer 

SSPY 

39.00 

Visual Cate 

SVCAFEMAC 

199.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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WebTen 

by Tenon 
Intersystems 

WebTen is an 
industrial-strength, 
high-performance 
Apache Web server for 
Power Macs. WebTen's 
Web-based browser 
interface enabies iocai 
or remote administration via your favorite browser. Since Apple’s NeXl 
acquistion, Tenon has extended their unique "UNIX virtual machine" 
technology to produce a set of “Rhapsody-Ready" internet 
applications, WebTen is the first offering in this series, 

• WebTen is the fastest Web server on Power Macintosh 

• Sustains up to 10,000 connections a minute, or over 10 million 
connections a day 

• Apache runs in Tenon's muiti-threaded, pre-emptive 
multitasking environment 

• Tenon’s unique technology supports the widely acclaimed Apache 
Web server as a double-ciickable Macintosh application 
(SWEBl^N) Our Price $495 


OOFILE Reporter Writer 

by A.O. Software 

• Full embedded report-writer, allows you to preview page-by-page 
and either print or save as plain text, KTML or RTF 

• Multiple levels of breaks, database views, headers and footers are 
provided using a clean object-oriented design 

• Incudes RAM-based version of OOFILE database. Included in ftill 
OOFILE Platform Bundle 

• Saving to file without preview of printing is cross-platform-run on 
your MacAWin/Unix server and creates web pages 

• Price includes 1-year subscription 
[SOORW) Our Price $499 



PageCharmer: Sizzling Effects. 






PageCharmer 1.0 

by Mainstay 

PageCharmer Is a set of customizable interactive applets that 
enhance web pages without writing a single line of HTML code. 
Whether the web site is already up and running or designing one 
from scratch, PageCharmer gives you the power to make it stand 
out from the crowd with sophisticated applets that can be 
personalized to fit most any need, 

FEATURES: 

LiveG-Map, LiveT-Map, LiveG-Button, LiveT-Button, LiveGT-Button, 
LiveG-Ticker, UveT-Ticker, LiveG-Marquee, and UveT-Marquee. 
(SPGCHRM) Our Price $139 


BBEdit 4.0.4 

by Bare Bones 
Software 

A powerful, easy-to- 
learn text editor. Adds 
new features for HTML 
coders, including a 
spelling checker and 
HTML tag palette. 
Accelerated for Power Macintosh; dragging supported 
everywhere; Internet Contig aware; PowerTalk aware. 
Integrated support for Symantec’s IDE, Metrowerks 
CodeWarrior, THINK Reference 2.x, MPW ToolServer, and most 
other environments. Many UNIX style tools, including “grep” 
searches, file comparisons, and sorting multi-tile search and 
replace. PopUpFuncs feature lets you jump to a function from 
a menu. 

(SBBEDIT) 0urPrice$119 





WebSiphon 

by Purity Software, Inc. 

WebSiphon is one of the most 
anticipated new CGI products for 
Macintosh Webmasters delivering a 
complete authoring tool for truly 
revolutionary sites. This product 
alone can replace most all CGIs on 
your site resulting in increased dynamic serving speed, 
reliability, and powerful scripting and database abilities directly 
within your HTML pages! Also includes Verona, the fastest flat- 
file database server available for Macintosh web sites. 
(SWSIPHON) Our Price $495 


ObjectSet Mail SDK 

by Smartcode Software 

• Powerful C-i-t- classes for integrating 
Internet e-mail in your applications 

• Helps you write software that can share 
mail with other leading e-mail products 

• Royalty-tree MIME, SMTP, and POPS APIs 
for Macintosh, Windows, and Unix 

• Gives you the most robust MIME parser and encoder available 

• Ideal for use in Internet and Intranet environments 

• Comes complete with samples with documented, reusable 
source code 

• Free standard technical support 
(SOSMSDK) Our Price $495 
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Roaster 

by Roaster Technologies, Inc. 

Roaster Release 3.1 is now available with JDK 1.1 and JavaBean 

support! Get the most out of Sun's Java™ programming language 

with this powerfui development environment. 

• Features include; ability to build stand-alone Macintosh 
applications or applets; visual interface builder; ability to create 
cross-plattorm zip files; powerful Java debugger; wizard for quiddy 
creating Java applets or applications; JavaBean support; JDBC 
support: Java object database included; ability to call AppleScripts 
from Java: Just-in-time (JIT) compiler: JDK 1.1 .x support; class 
tree and hierarchical class browser; much more! 

• Software includes: Over 300 example applets and applications; 
Netscape Internet Foundation Classes; Object Design’s PSE for 
Java: OpenLink Software's JDBC Drivere: OpenSpace Java Generic 
Library: Microline Component Toolkit Lite 3.0: much more! 

• Requirements: Runs on 68k or PowerPC, CD-ROM 

• Price includes all web based updates 
(SROAST3) Our Price $99 


Power MachTen 4.0.3 

by Tenon Intersystems 

MachTen is the only Macintosh product that can turn your 

Macintosh into a complete Unix workstation. Based on 

BSD4.4 and the Mach kernel, MachTen brings the power 

of Unix to your desktop at an extremely attractive price point. 

MachTen enables you to: 

• Run a high speed internet server, complete with WWW, FTP, NFS, 
DNS and print service 

• Build a Mutihomed Web Server 

• Develop applications in a Unix development environment, replete 
with the acclaimed GNU development toolset 

• Program in Ada, C. C++, Pascal, Fortran, and more 

• Run Xwindows applications, from remote workstations or on 
your Macintosh 

• Run hundreds of Unix applications, already ported for MachTen 
and available on our Ported Applications CD-ROM 

• Run Sof1ware.com Inc’s acclaimed Post.Office mail transport service 
(SM10PPC) Our Price $695 
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Rumpus 

by Maxum Development 

Maxum's new, high- 
performance FTP server for 
the MacOS. Based on 

Maxum's RushHour TCP/IP implementation. Rumpus 1.0.1 offers 
the performance and reliability of high-end workstations with the 


ease of use. security, and flexibility of the Macintosh. 

• Simplified setup, with no need to configure AppleShare. File 
Sharing, or Usere & Groups for simple anonymous FP 

• Anonymous and/or secure server access, with separate 
security settings for anonymous vs. secure users 

• Automatic MacBinary and Binhex encoding 

• Complete logging, with separate anonymous and secure 
access logs, including anonymous user passwords 

• Up to 32 simultaneous connections 
(SRUMP) Our Price $195 


ScriptDemon 

by Royal Software, Inc. 

ScriptDemon is a browser plug-in that, for the first time, allows you to 
deliver and run AppleScripts from Web pages. The ScriptDemon plug¬ 
in will execute the embedded AppleScript code included on a Web 
page. ScriptDemon painlessly and inexpensively handles many 
previously impossible tasks, such as: 

• Using the Intranet to manage all Macintosh computers on-line 

• Using the internet to install and configure software 

• Using the internet to configure hardware 

• Delivering complex sets of files and assembling them on the 
browsing computer 

• Providing interactive education and product support on both the 
Internet and Intranet 

• A perfect companion to LiveCard! 

(SSDEMON) Our Price $949 



CGi Toolkit 

by Pictorius Inc. 

The Pictorius CGi Toolkit is the fast and 
easy route to high performance CGIs 
and ACGIs for your Mac Web site. 

•Interactively develop CGIs white the 
web server, the CGI Toolkit and the browser are running on the 
same machine 

• Interactively develop, test and debug CGIs before compiling 

• Powerful debugger allows you to edit code, roll teck, code and 
change input values while your application is running 

• Fully object oriented so you can re-use your code 

• Automatic handling of Apple Evente so you can concentrate on 
building functionality 

• Easy creation of multi-function CGIs which reduces application 
footprint and RAM usage 

(SCGITLKT) Our Price $149 
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FaceSpan v2.1 

by Digital Technology International 

• Develop integrated software, make stand 
alone applications, create friendly 
interfaces 

•Develop quick prototypes, print muitipie 
pages with sophisticated layouts 
•Script essential elements of the FaceSpan 
application - Enhanced save options 

• Play and record sounds as either “snd" resources or as "AIFF’ files 

• Create miniature or complete apps that run on either Power PC or 
68k computers 

■ Use precise time measurement for impiementing timed behaviors 
— New properties 

• Proportionally xale PiCT images -Align images in a pictbox - 
Automate any application 

• Monitor and respond to low-memory sltuations-lncreased support 
for Frontier UserTatk! 

(SFACESPAN) Our Price $299 


PreFab Player 

by PreFab Software, Inc. 

PreFab Player is a faceless background application (similar to a 
system extension) that lets your scripts query and control othenwise 
non-scriptabie applications, desk accessories and control panels. 
Player adds verbs that directly manipulate the Macintosh user 
interface: choose from menus & pop-ups, select radio buttons, type 
text, determine the name of the frontmost window, the state of a 
check box, etc. Balioon help identities non-standard dialog items. 

• Adds verbs to ^pleScript and to Frontiers UserTalk 

• Controls the Frontmost Application 

• Balloons Identify User Interface Objects 
(SPLAYER) Our Price $95 



Scripter 2.0 

by Main Event Software 

For professionals, for novices, for 
webmasters, for solutions providers, there's 
only one serious choice, Scripterl 
• Scripter and FaceSpan work together: one 
click opens your FaceSpan script in 
Scripter, another sends it back 

• Debug handlers without modifying your scripts using the Call Box 

• Applet simulation, live editing, Object map. associated terminology 

• Search backwards, block generators, more navigation shortcuts, 
more drad-and-drop, and an even more enhanced trace log 

• Now Includes ScriptBase; stores your dab and media elements 
and share them between scripts ail with a special new browser 

• Easily write and compile scripts that have handler declarations 
and other vocabulary specific to a particular scriptable application 

• Scripter is the natural companion to AppleScript for users at all 
levels of proficiency. Don’t write scripts without it! 

(SSCRIPTER) Our Price $199 




AppleScript Software 
Development Toolkit 1.1 

by Apple Computer, Inc. 

• AppleScript language, system software 
extension, and script editor 

• FaceSpan 1.0 

• Developer's redistribution license for 
AppleScript System software extension 
and FaceSpan runtime code 

(SASDT) Our Price $49 
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Script Debugger 

by Late Night Software Ltd. 

• A powerful and flexible AppleScript 
authoring tool - get the most from 
AppleScript! 

• Advanced debugging environment offers 
single-step script execution with 
breakpoints 

• Script Debugger dictionary browser 
features a graphicaf view of objects provided by scriptable 
applications 

• Includes Late Night Software Scripting Additions - a collection of 
more than 70 new AppleScript commands, and Scheduler, a utility 
that allows you to launch scripts at pre-determined times 
(SDEBUG) 0urPrice$129 



TCP/IP Scripting Addition 

by Mango Tree Software 

•Award-winning AppleScript scripting 
addition 

•Allows you to write scripts using 
MacTCP™ commands in AppleScript™ 
•Send e-mail or tiles through a script, 
check if users are logged on (via Finger), automate FTP. Gopher, 
NetNews, Telnet, and LPR, verify links in HTML documents, and 
quickly write many other TCP/IP client-server programs 
• Works with AppleScript. MacTCP 2.0.4 and Open Transport 
(STCP) Our Price $49 


WindowScript 

by Royal Software, Inc. 

WindowScript is the ultimate tool for designing Macintosh user 
interfaces using HwjerCard. Design Real "Macintosh” user- 
interfaces right inside HyperCard. Until now you either created 
HyperCard stacks w Macintosh applications. With WindowScript 
you can literally bring the look and feet of a real Macintrsh user- 
interface to HyperCard. If you're a HyperCard developer, interface 
designer, application developer, program manager or tester 
searching for a prototyping tool, WindowScript is perfect for the job. 
(SWSCRIPT) Our Price $149 
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Apple Media Tool Programming Environment 2.1 Multimedia Authoring with Apple Media Tool 

by Apple CJomputer, Inc. by Apple Computer, Inc. 


This object-oriented language and application framewodt allows 
programmers to customize features used within the Apple Media 
Tool authoring environment 

Includes an expanded Apple Media Language (AML) class library, 
incremental compiling and linking of AML code, faster debugging 
facilities, Macintosh Programmers' Workshop (MPW), and user-oriented 
documentation written from an AMTT? developer’s perspective 
Portable across 68K, Power Macintosh, and Windows platforms 
(SAMTPE) Our Price $995 


Apple Media Tool offers new multimedia users a way to get started 
creating interactive multimedia with minimal learning time. This self- 
paced tutorial will make Apple Media Tool (AMT) even easier to 
understand and to use. Using this tutorial, you will create a realistic 
multimedia project using exciting techniques such as QuickTime 
movies, animation and more. A demo version of AMT is included and 
can be used for the exercises. Training Format: Tutorial with labs. 
(SMWAMT) Our Price $49.95 



QuickTime Developer’s Kit 2.0 


QulckTim9*VR 


Virtual Reality 

Programming 

with QuickTime VR 2.0 

by Apple Computer, Inc. 

• Virkjal Reality Programming 8ook/CD-R0M 
for QuickTime VR 2.0 

• Enables you to write C and C-t-i- programs 
using QuickTime VR 2.0 

• Allows QuickTime VR to be used in 
games, multimedia titles and other 
programs 

• QuickTime VR 2.0 objects can be zoomed 
in on, panned, or linked with hots spots 

• Both panoramas and objects have hot 
spots linked to World Wide Web URLs 
(SVRPQT) Our Price $49 


by Apple Computer, Inc. 

• QuickTime 2.0 Extension. QuickTime Power 
Macintosh Extension, and QuickTime 
Musical Instruments extension 

• Utilities like MoviePlayer 2.0,16-bit Audio 
Compression, etc. 

• Sample content such as MPEG Movies, 
Music Movies, Time-Code Movies, and 60 
field per second movies 

• Includes software-only playback features 
such as faster 2x playback mode for 
current compressors, /^ple Cinepak 
compressor, 1 -bit fast dithering, network 
tuning, load-into-RAM option, and Photo 
CD support 

(SQTDK) Our Price $99 



Clip VR™ 

by eVox Productions 

Clip VR"" is a new digital image library 
offering high quality Photographic Virtual 
Reality (PVR) images for use with Quicktime® 
VR and other desktop VR tools. 

Clip VR"" Panoramic Image ramponents include 
alpha channel masks. Combine elements into a 
composite panorama iMiich is converted to the 
finished QuickTime VR movie using Make QTVR 
Panorama Tod. The Components (“Cilps") 
include complete 360 degree scenes, 
libraries of 360 degree terrains. 360 degree 
skies, buildings, and objects. Images are 
provided as .PICT files AND QuickTime VR 
movie files. Clip allows you to create 
high quality VR worlds from pre¬ 
photographed component images. Clip VR"^” 
can be used to add excitement to a web site, 
to increase the interactive value of a CD- 
ROM. Of simply for fun! Requires Imaging 
editing program such as Adobe Photoshop* 
to perform .PICT image compositing, 
(SCUPVR) Our Price $89.95 
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QuickTime VR 2.0 
Authoring Toois Suite 

by Apple Computer, Inc. 

• QuickTime VR is a cross-platform software 
from Apple which enables webpage 
designers and professional developers to 
create new multimedia products and 
webpages incorporating QuickTime VR 
content. With QuickTime VR, users 
interactively navigate through 360“ views 
of space, and explore three dimensional 
objects on Macintosh or Windows-based 
personal computers 

• The QuickTime VR Authoring Tools Suite is 
a set of Macintosh tools to create and link 
panoramas and objects from 


photographic, digital, video, or computer 
generated images 

• Included is a complete set of 
documentation for planning, designing, 
photographing, and creating QuickTime VR 
panoramas and objects. The aubtoring 
tools also allow you to link objects to 
panoramas using clickable hot spots 

Included on the CDs are: 

• A software tool (MPW-based) that stitches 
and blends adjacent images into a 
panoramic PICT file 

• A software tool (MPW-based) that dices 
and compresses panoramic PICT files to 
less than 100 KB (low resolution) per 
panorama 


• A scene editor (HyperCard-based) to 
create Quicklime VR scenes by adding 
and positioning nodes, hot spots, linking 
nodes together, and for linking QuickTime 
VR objects to scenes 

• A variety of utility tools for formatting the 
data into the runtime software 

Due to a revolutionary distortion-correcting 
algorithm, QuickTime VR panoramas and 
objects maintain a normal perspective when 
the user moves the mouse. The speed ot the 
algorithm allows up to 24-fait color images. 
Both vertical and horizontal panning can 
occur at fast speeds. 

(SQTVRATS) Our Price $395 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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Media Cleaner 

by Tenran Interactive ^ 

Use Media Cleaner Pro 2.0 to optimize and compress video for 
CD-ROM. kiosk, or the Internet. Media Gleaner Pro automates 
your work flow allowing you to get the highest quality video, 
faster and easier than any other program on the market. 

• Includes Adobe Premiere Export module 

• Optimal palette generation. Drag-and-drop batch processing 

• RealMedia. VDOUve and improved QuickTime support 

• Dynamic Preview Window, the Media Wizard, multiprocessor 
support and more! 


Captivate 4.6: 

Essential Graphics Utilities 

by Mainstay 

Captivate'” 4.6 is a powerful collection of 
graphics utilities for Macintosh, based on 
Mainstay's acclaimed screen capture utility, 
graphics and multimedia scrapbook, and 
graphics viewer. Captivate provides essential graphics utilities to the 
professional and hobbyist alike. 

• Package includes; Captivate Select, Captivate View, and Captivate Stole 

• Any one of the three can be used alone, and together they make 
an unbeatable team 

• Whether writing a training manual, creating an ad, or just creating 
a startup screen from your favorite picture. Captivate is everything 
professionals need at a price anyone can afford. 

(SCAPTIV) Our Price $79 



System Requirements: 

68040 Mac or better (PowerPC strongly recommended, req'd for 
RealMedia), QuickTime 2.0 or later (2,5 strongly recommended) 

8 Mb application RAM, MacOS 7.0.1 (7.5 or later recommended) 
SoundManager 3.2, CD-ROM Drive 
(SMCP) Our Price $359 

Registered owners of Movie Cleaner Pro 1.3 or earlier can upgrade 

$129 


Music liracks 

by BeachWare, Inc. 

A new PCVMac & Audio multimedia music CO-ROM. The clips include 
musical introductions, fanfares, background music, and more. This 
collection offers you 100 music clips stored in WAV format for 
Windows. SoundEdtt & AtFF formats for Macintosh and as Audio 
tracks for audio CS players. All of the music clips are completely 
license and royatty-free!! Mac System requirements; Mac Plus or greater, CD-ROM drive. PC 
system requirements: Windows 3.1 or later, Sound Blaster compatible board, CD-ROM drive. 

(SMT) Our Price $24 

Order TelMree 
800-MACDEV-1 

1800 * 22 - 3381 | 

MultiWare 

Multimedia Collection 

by BeachWare, Inc. 

Introducing a new Audio multimedia music CD-ROM for the 
Macink^. This disc is a collection of clips ideal for Desktop 
Presentations and other Multimedia applications. This incredible 
collection of license-free media clips is bursting with 2AO+ color pictures and backdrops (PICT), 
200-1- sound & mu^c clips (SoundEdlQ. 140-f QuickTime movies, and a vanety of multimedia 
tools for use with the Macintosh. 

(SMWMC) Our Price $24 



(SMCPUP) Our Price 
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AudloTrack 

by WAVES 

AudloTrack is a 
software plug-in for 
native processing on 
digital audio 
recording and editing 
systems. Waves 
AudioTrack combines the most-needed audio 
processors into a single piece of software, 
including 4 bands of equalization, 
compression/expansion, and noise gating, 
AudioTrack is ideal for preparing audio for 
InterNet streaming formats, processing 
individual mono/stereo tracks of audio and 
audio lor video editing systems including 
digital sequencers. 

Feature list 

• A single window interface 

• 4-band ParaGraphic Equalizer, 
Compressor/Expander and Gate 

• Instantaneous A/B comparisons of on-line 
settings 

• Pretested setup libraries supplied for 
various processing solutions 

• Power Macintosh native processing 
(requiring no DSP board) 

• Volume and gain reduction meters 

• Peak hold and clip meters 

Requirements: 

The AudioTrack is compatible with all 
machines supported by Deck It, SoundEdit 16, 
Adobe Premiere 4.0 and Cubase \fiT 3.1 
(SAUDIOTRK) Our Price $270 
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Casino! 

by BeachWare, Inc. 

Can't make it to Vegas this month? Your 
best bet is Casino! Whether your favorite is 
Sloto, Poker, Blackjack, or Keno, this virtual 
casino vi/ill entertain you for hours with its 
ten different machines. Mac System 
requirements: Color Mac, CO-ROM drive, 4 MB of RAM. PC system 
requirements: Windows 3.1 or later, CO-ROM drive, 4 MB of RAM. 
(SCAS) Our Price $24 



Abuse 

by Bungle Software 

Abuse is 360 degrees of side-scrolling action. 

Run, jump, fall and fly in any direction - through 
Industrial corridors, caverns and sewers. Des^ 
enemies in any direction with grenade launchers, 
rocket launchers, napalm and nova spheres! Avoid 
deadly traps with jet packs and trrbo boost! 

Key Features: 

• Make your own mayhem with the Level Editor 

• Hunt down your friends in 8-person muttipiayer games 

• Awesome Arsenal. Napalm Bombs, Nova Spheres and the Death Saber: 
just a few ways to lay waste! 

• Point and Kill Interface. Move and annihiMe mutants in complete 360° freedom 

• Blast your way through floors, walls and ceilings in search of the ultimate 
power-up! 

• Abuse is 360 degrees of side-scrolling action. Run, jump, fail and fly in 
any direction - through industrial corridors, caverns and sewers 

• Destroy enemies in any direction with grenade launchers, rocket 
launchers, napalm and nova spheres! Avoid deadly traps with jet packs 
and turbo boost! 

(SABUSE) Our Price $51 



1000 Games for 
Macintosh 

by BeachWare, Inc. 

The best Macintosh game disc in ttie 
entire world, this CD-ROM contains over 
one thousand great shareware and public domain programs. Battle ugly 
aliens, blast apart lun-away asteroids, deal yourself that royal flush or 
solve that 3-D pu 2 zle. this disc has it all! System requirements: Mac 
Plus or greater, CD-ROM drive, and 2 MB of available RAM (4 MB of 
RAM when running under System 7). 

(STGM) Our Price $24 



Classic Arcade 

by BeachWare, Inc. 

Ten of your favorite coin-arcade games, 
redone with killer graphics and sounds! Walk 
through a virtual arcade and test your game 
playing skills with these exciting arcade 
classics. Ten games, including Moon Lander, 
Astro-Boing, Hyper Hockey. Ballistic Avenger, and more. System 
Requirements; Mac - Color Mac with 8 MB RAM, CD-ROM drive. PC 
486 with 8 MB RAM. Sound card, SuperVGA,CD-ROM drive. 

(SCLA) Our Price $24 

Marathon IHIofiy Box Set 

by Bungle Software 
The Marathon Trilogy Box Set brings all three 
Marathon games together In one affordable package, 
with tons of extras thrown in. Besides Marathon, 
Marathon 2: Durandal and Marathon Infinity, you'll 
also receive a staggering t200 maps, featuring 
never-reteased Bungle maps and the winners of the 
Infinity Mapmaking Contest. The Marathon Scrapbook 
(a bebind-lhe-scenes look at Ihemaking of the Maratton games). Marathon 
collectables like the Marathon 3-sticker set, and to top it off, the award- 
winning game that laid tie groundwork for Marathon; Bungle's breakthrough 
Pathways Into Darkness. 

The Marathon Trilogy Box Set is native to the Power Macintosh, utilizes the 
graphics acceleration of 630 and 6200 machines, is 8,16 and 24-hit color 
capable, and can be played with joysticks and game pads. The package 
requires a 68040 or higher Macintosh,CD-ROM drive, 8-bit color monitor 
(13” recommended, and System 7 or later. 

(SMTBS) Our Price $65 




IHvia Warehouse 2000 

by BeachWare, Inc. 

Introducing a fun new PC and Mac CD- 
ROM. This disc contains two thousand 
tivia quesbons. in 45 categories, in 
several game formats! Test your memory 
witti tlte O&A, Concentration, and Multiple 
Choice games! Categories include; 
Animals. Bodies. Bond, Bugs, Cities. Comics, Geography, Giiiigan, 
Gross, Health, Holidays, Horrors, Kids. Knot's Landing, Math. Movies, 
and many more. Mac System requirements: Color Mac, CD-ROM 
drive, 4 MB of RAM. PC system requirements: Windows 3.1 or later, 
CD-ROM drive. 4 MB of RAM. 

(STW2K) Our Price $24 



yfAl^*** 

There'* 


Here are more products. For full product descriptions please see our Web 
site, or feel free to call, fax, or E-mail us. 

PRODUCT CODE OUR PRICE 

A Zillion Sounds SAZS 24.00 

Night Sky Interactive SNSI 24.00 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 
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System 7.5 Technologies 

by Apple Computer, Inc. 

■ Self-paced course designed to allow 
software developers to write code that 
extends the functionality of an application 
for System 7.5 

• Contains comprehensive materials for drag-and-drop, threads, 
standard mail package, and QuickDraw GX printing 


Students should be familiar with the basics of developing an 
applicafion on the Macintosh. Metrowerks CodeWarrior Lite is 
included on the CD with the lab exercises. The lab assignments were 
developed in CodeWarrior 8. The labs can also be done in another 
development environment but project files for them are not provided. 


Training Format: Tutorial with labs. 

Requirements: Macintosh or Mac-OS compatible computer with a 
68020 processor or greater (PowerPC preferred); 8 MB RAM; 25 
MB hard disk space; System 7.5 or later; CD-ROM drive. 



Apple Guide Integration 

by Apple Computer, Inc. 

• Self-paced overview teaches you when and 
how to add Apple Guide help to your program. 

• Powerful help system that can guide the 
user through a task. 

• Tutorial will lead you through the steps necessary to integrate 
Apple Guide into your application. CodeWarrior Lite is included on 
the CD with the lab exercises. 


Training Format; Overview with labs. 

Requirements: Macintosh or Mac-OS compatible computer with 
68020 processor or greater, PowerPC preferred; 8 MB RAM; 25 MB 
hard disk; System 7.5 or later; CD ROM drive. 

(SAGI) Our Price $49.95 


(SSYSTECH) Our Price $49.95 


Virtual llitor for QuickTime VR 




by Apple Computer, Inc. 

• Self-paced, hands-on course, which 
provides a comprehensive environment for 
learning the steps of the QTVR 
development process. The student can 
cover all of the topics or choose areas to 
focus on. Topics covered include: QTVR 
capabilities and key concepts, panoramic 
movies, object movies. QTVR Scene 
movies and authoring with QTVR 

• CD-ROM contains lots of useful examples 
and demos, in addition to all the step-by- 
step exercise files 


If the student completes the entire course, 
he/she will create a complete, authored 
multimedia project similar to the 
demonstration title that comes on the 
enclosed CD-ROM, There are approximately 
3-4 days of training. 

Training Format Tutoria) with labs. 

Requirements: 40 MB RAM minimum, 64 
MB preferred; Macintosh or Mac OS- 
compatible computer with a 33 MHz 68040 
processofor greater; System 7.1 or later; 
CD-ROM drive; 17" color monitor. 
(SVTFQTVR) Our Price $79.95 



Apple’s develop™ 
back issues are 
available for only 
$10 per copy. 

To place your 
orders, call 

800/MACDEV-1. 






M A G A Z I E 


MacTech® Magazine 

MacTech keeps Mac programmers & developers up to date with 
everything they need to know about software development. Topics 
like Rhapsody. Java, QuickTime, OPENSTEP, Objecfive-C. C/C-m-, 
Object Oriented Technologies, product reviews and much more! 
Subscriptions: 

(MTYRDM) US/Domestic for 12 issues $47 

(MTYRCM) Canadian for 12 issues $59 

(MTYRFM) International for 12 issues $97 

Back Issues: each plus shipping (subject to availability) $10 
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metrowerks 


CodeWarrior Wear 

You live it, you breath it... you 
might as well wear it! (XL only) 



Alien T-Shirt 

(AALIEN) Our Price $9.95 

Arnold T-Shirt 

(ACWARNLD) Our Price $9.95 

Arnold Jr. T-Shirt 

(AARNOLDJR) Our Price $9.95 

Blood, Sweat & Code T-Shirt (SS) 

(ACWSBLOOD) Our Price $9.95 

Blood, Sweat & Code T-Shirt (LS) 

(ACWLBLOOD) Our Price $14.95 

CodeWarrior Baseball Cap - Black 

(ACWBHAT) Our Price $14.95 

CodeWarrior Sweatshirt - Black 

(ACWSWEAT) Our Price $29.95 

CodeWarrior Hawaii Five-0 Shirt 

(ACWHAWAfI) Our Price $9.95 

CodeWarrior Winter Hat 

(AWINHAT) Our Price $14.95 

Debugger Boxer Shorts 

(ADBOXER) Our Price $16.95 

Discover Programming T-Shirt 

(ADISCPT) Our Price $9.95 



Podeum Sport 

by Racti, Inc. 

Now you can have laptop stability, drop 
protection & mobility. If you're looking 
tor an inexpensive, nwr-technical gift 
for a laptop owner - look no further. 

• Strap your laptop to your leg 

• Universal size - fits all laptops and 
all legs (13"-46"} 

• Veicro Velcoins attach your laptop to the podeum 

• Podeum allows working angles up to 90 degrees 

• Dropped laptops account for 41 % of all laptop fatalities 

• Manutacturer's lifetime warranty. 


(APODSP) Our Price $39 



lUlacTech® Mouse Pad 

Slide on this! With an extra-large surface (11" by 10”) and 
a deluxe sleek plastic coating, you’ll be zooming across 
your screen in no time at all. Speed limit not enforced! 
(AMTPAD) Our Price $8.95 
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Getting Started With WebObjects 

by NeXT Software, Inc. 

If you're a first time user, start here to learn the basics of how to 
create and run WebObjects applications. 

(BGSWO) Our Price $14 

WebObjects Developer's Guide 

by NeXT Software, Inc. 

A guide to building and understanding WebObjects applications. 
Takes a close look at the WebObjects scripting language. Additional 
sections explain the WebObjects architecture and tells you how to 
integrate your code into the request-response loop, create reusable 
components, create client-side components, take advantage of 
powerful Foundation Framework features, and more. Riled with 
example code. For all WebObjects programmers. 

(BWODG) Our Price $16 

D'OLE Developer’s Guide 

by NeXT Software, Inc. 

Distributed OLE is available today, and this book shows you how to 
use it. Using real-world examples, the book steps you through the 
process of making your OpenStep objects available on Windows 
through OLE. 

(BDOLEDG) Our Price $22 

Discovering DPENSTEP, Mac 

by NeXT Software, Inc. 

Introduces programmers to NeXT's OPENSTEP 4.0 Developer product 
by guiding them through the creation of three applications of 
increasing complexity. The tutorials demonstrate and explain 
programming techniques, Objective-C fundamentals, common APIs, 
and usage ot the developement tools. Along the way they present 
summaries of important concepts and paradigms. The book also 
includes a chapter directing readers to programming resources, 
further information, and services such as baining and support. An 
appendix offers a concise discussion of object-oriented programming. 
(BDOSTEPM) Our Price $15 

Discovering DPENSTEP, Windows 

by NeXT Software, Inc. 

Discovering OPENSTEP provides an introductkMi to OPENSTEP 
programming on Windows NT. It guides the reader through the 
creation of three applications of increasing complexity. Alortg the way, 
it explains concepts and illustrates aspects of Objective-C, OpenStep 
classes, the development environment, and programming techniques. 
A short appendix offers a summary of object-oriented programming. 
(BDOSTEPW) Our Price $16 



Dbject-Driented 
Programming and Dbjective C 

by NeXT Software, Inc. 


An introduction to the principles ot object-oriented programming in 
OPENSTEP and the official description of the Objective-C language. 
Objective-C is easy to learn and use because it adds very little 
syntax to the C programming language. It's dynamic nature allows 
you to accomplish things not possible In most other object-oriented 
languages. For any OPENSTEP programmer. 

(BOOPOC) Our Price $24 

Working w/ Interface Builder (for eof) 

by NeXT Software, Inc. 

A hands-on, award-winning book designed to help you get your job 
done with the updated Interlace Builder, released with NEXTSTEP 
3.3 and the Enterprise Objects Framework 1.1. For any programmer 
using Interface Builder to design objects Ihal truly work in 
NEXTSTEP. 

(BWIB) Our Price $24 

Using EDF 2.1 w/ DPENSTEP (Mac & Windows) 

by NeXT Software, Inc. 

Using Enterprise Objects Framework with OPENSTEP describes how 
to create an Enterprise Objects Framework application on 
OPENSTEP. It includes a tutorial and a chapter on creating a user 
interface for an OPENSTEP Enterprise Objects Framework application. 
(BUEOFQ) Our Price $14 

EOF Developer's Guide for EOF 2.1 (Mac & windows) 

by NeXT Software, Inc. 

The Enterprise Objects Framework Developer's Guide describes how 
to develop database applications using the Enterprise Objects 
Ffamewort< tools and classes. It Includes an architectural overview of 
the product, and descriptions of programming lips and techniques. 
An appendix offers a summary of Entity-Relationship Modeling. 
{BEOFDG) Our Price $24 

EOF Developer's Guide for EOF 2.0 {BEOFDG20) Our Price $24 
EOF Developer's Guide for EOF 1.x (BEOFDG IX) Our Price $24 
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Increasing Hits and 

SflllNliltllBl 

Selling More on your 

iHfasnt 

Web Site 


by Greg Helmstetter 


Written especially for entrepreneurs, 


corporate marketing managers, small 


business owners, and consultants, this 

■11. M 1 H ! I 1 ■ i r 

valuable guide gives you rare tips and 
tricks you need to know to make your 


site a commercial success. 

(BIHSMWS) Our Price $22.45 

Measuring the Impact of 
Your Web Site 

by Robert W. Buchanan and 
Charles Lukaszewski 

This book features case studies from 
many successful and some less 
successful corporate web site pioneers. 
You will l^n techniques and 
commercially available tools for 
measuring site traffic and visitor behavior-and help you choree the 
right orres for the job. Written by leading corporate site consultants ttris 
book tells you how to develop a management strategy geared toward 
optimizing web site productivity. 

(BMIYWS) Our Price $26.95 
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The Way Computer 
Graphics Works 

by Olin Lathrop 

A complete guide to mastering 
computer graphic basics. It is written 
in a frank, down-to-earth style 
covering everything from how 
computer graphics are different from 
fine art and photographs, to modeling, 
pixels, and the principles of animation. 
All of this is done without resorting to mind-numbing equations and 
impenetrable technical jargon. 

(BWCGW) Our Price $29.65 

Debugging Macintosh 
Software 

with MacsBug PCjg 

by Konstantin Othmer and 
Jim Straus 

MacsBug, from Apple Computer, Inc., 
is the leading debugging software 
program for the Macintosh. This 
book/disk package is an all-in-one kit 
for using MacsBug. Chapter 1 introduces MacsBug and describes 
the contents of the rest of #ie book. Chapter 2 describes how to 
install MacsBug and enough low level details about the Macintosh 
so that you can use MacsBug. Includes MacsBug 6.2 on disk. 
(BDMSWM) Our Price $31.45 
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The internet 
Strategic Pian 

by Martin A. Schulman and 
Rick Smith 

This bodt gives you all of the 
management tools you need for 
creating a strong Internet and Web 
presence. A blueprint for your strategic 
plan, this book guides you every step of 
the way in establishing your company's 
place on the Internet and Wodd Wide Web. 

(BTISP) Our Price $22.45 

The Web Navigator 

by Paul Glister 

This book keeps you right on top of all 
the recent changes in the Web, tells 
you what's out there right now and 
what's coming in the future. You'll get 
samples of various Internet sites and 
candid discussions of providers. You'll 
receive proven strategies for finding 
and managing information. 

(BTWN) Our Price $22.45 

JavaScript 
Cookbook 

by Yosef Cohen 

Everything you need to master the 
fundamentals of JavaScript 
programming is in this book/CD-ROM 
package. A special easy-to-use 
reference section offers detailed 
analysis and examples of objects, 
properties, event handlers, and 

statements. You'll also find alt the latest information relevant to 
JavaScript programming since the advent of Mavigator 2.0. 

(BJSCB) Our Price $44.99 


HTML Sourcebook, Srd 
Edition 

by Ian S. Graham 

Critics everywhere agree. HTML 
Sourcebook is the best guide to HTML 
for Web professionals. That's because 
no other book makes it so easy for you 
to quickly master all the commands, 
tools, and expert techniques you need 
to create cutting-edge Web page 

dxuments. Completely revised and expanded by nearly 50 percent, 
this new third edition of the best-selling guide to HTML gives you the 
complete lowdown on all the changes and enhancements to the 
HTML, HTTP, and URL standards. 

(8HTMLS) Our Price $26.95 


JavaScript 
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Designing 3D Graphics 

by Josh White 


in this powerful book/CD- 
ROM package, top 
computer graphics artist 
Josh White tells you 
everything you need to 
know to create sophisticated real-time 
3D graphics for computer games and 
virtual reality. This book contains the in- 
depth knowledge of software tools and hands-on modeling 
techniques that Josh White has learned while creating artwork for 
over 20 commercial games, including Descent, Zone Raiders, Locus. 
Legoland, and otliers. 


(BD3DG) Our Price $ 35.95 



Web Marketing 
Cookbook 

by Janice M. King, Paul Knight, and 
James H. Mason 

Create the ultimate Web 
marketing site, quickly 
and painlessly! Learn how ^ 
to build a Web site for *'^**hK^ 
your small business or nonprofit 
organization with this step-by-step 
approach. This book/CD-ROM package contains your simple, non¬ 
technical tools for converting your print brochures, text, and graphics 
into a powerful online promotion. 

(BWMCB) Our Price $ 35.95 
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Developing CGI 
Applications with Perl 

by John Deep and Peter Holfelder 

A complete step-by-step guide to 
creating sophisticated interactive CGI 
applications using Perl. It you’re ready 
to build your own customized 
interactive documents, forms, graphics, 
and other fuli-feature CGI applications 
using Perl, then this book will show you 
how. Covers CGI, HTTP, and the Perl scripting language. 

(BDCGIA) Our Price $ 26.95 



Rhapsody DeveloperDS Guide 

by Jesse Feiler 

Covers the basic architectoral principles of Rhapsody: the Mach 
microkernel, object-oriented programming, and the elements of a 
modem OS such as preemptive multitasking, protected memory, and 
symmetric multiprocessing. Also shows ways of getting to this new 
environment—Objective C, conversion tools, and the integration of 
Java—to develop Rhapsody products. Paperback. 450 pages. 
(BRDG) Our Price $ 35.95 


Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Practical Object- 
Oriented Development 
in C-I-+ and Java 

by Cay S. Horstmann 

This book offers advice on reai-wortd 
ways to use these powerful 
programming languages and 
techniques. Using the Unified Modeling 
Language (UML) methodology, expert 
Cay S. Horstmann gives you clear, concise explanations of object- 
oriented design. C-n-, and Java in a way that makes these potentially 
daunting operations more accessible than they’ve ever been before. 
(BPOOD) Ouf Price $ 31.50 


WebMaster in a Nutshell, Deluxe Edition 

by O'Reilly & Associates, Inc. 

Cross-platform, completely portable, and lightning fast, 
the CD-ROM is an invaluable addition to the 
webmaster’s toolbox. The CD-ROM contains the Web 
Developer’s Libaray—the full text of the latest editions 
of five popular O’Reilly titles; "HTML: The Definitive 
Guide, 2nd Edition": "JavaScript: The Definitive Guide. 2nd Edition"; 
“CGI Programming on the World Wide Web"; "Programming Perl, 

2nd Edition”; and “WebMaster in a Nutshell." The Deluxe Edition 
also Includes a printed copy ot ’’WebMaster in a Nutshell." the all- 
inclusive quick reference that belongs next to every webmaster’s 
terminal. Includes CD-ROM & 356 page book. 

Requirements; The CD-ROM is readable on all platforms, but requires 
a web browser that supports HTML 3.2, Java, and JavaScript. 
(BWMNUTD) Our Price $ 62.95 




Programming For The 
Newton Using 
Macintosh, 2nd Edition 

by Julie McKeehan and Neil Rhodes 

This book gives you 
everything you need to 
create Newton 2.0 
applications. From the 
people who developed the 
Newton programming training materials for Apple Computer, this 
book uses a clear and comprehensive approach to teach you how to 
program the Newton. Includes a CD-ROM full of sample code and 
additional goodies. The samples include solutions to all of the coding 
examples found in this book. Each example and exercise also has a 
narrated QuickTime movie showing the solution from start to finish 
in Newton Toolkit. 

(BPFNUM2) Our Price $ 31.45 
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Wireless For 
The Newton H I 

by Julie McKeehan and Neil Rhodes 

A book that picks up where 
Programming tor the Newton left off, 
teaching the reader how to develop 
Newton software on the Macintosh. The 
enclosed floppy disk provides a sample 
application, as well as a fully functional 
demonstration version of Newton Toolkit. 

• Learn to develop Newton software on the Macintosh 

• Hands-on Newton environment training with sample code 

• Includes disk with sample source code for a Newton application, 
as well as demonstration NTK - the complete development 
environment for the Newton 

(BWIRELESS) Our Price $31.45 
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JavaScript 
& Netscape Wizardry 

by Dan Shafer 

The perfect book to show you how to 
turn Netscape into your 
own personal, 
customized operating 
system. Provides the 
inside tips and 
techniques tor making your Web 

pages much more attractive. Shows you how to use all of the key 
features of the JavaScript language, including objects, methods, 
properties, events, and much more. Includes CD-ROM with 
numerous interactive scripts written in JavaScript you can add to 
your Web pages today. A complete set of the best Java applets. 
Useful plug-ins designed to supercharge Netscape and resources to 
help JavaScript programmers. 

(BJNWIZ) Our Price $31.45 




JavaScript 1.1 
Developer’s Guide 

by Arman Danesh and Wes Tatters 
Written by developers for 
developers. An advanced 
guide to creating 
professional Web 
applications with 

JavaScript 1.1 as deployed in Netscape 
Navigator 3.0, Microsoft internet 
Explorer 3.0, and LiveWire. Includes CD-ROM with Sun's Java 
Developer’s Kit. JavaScript and HTML Editors for Windows and 
Macintosh, 20 contributed ready-to-run JavaScripts and JavaScript 
examples from the book. 

(BJSDG) Our Price $44.99 




no 


Web Graphics 
Tools and 
Techniques 


V 


Web Graphics Tools 
and Techniques 

by Peter Kentie 

The ultimate source of information on 
Web graphics for both Macintosh and 
PC users. Recent technologies covered 
include: ActiveX. Sound. Adobe Acrobat, 
Java. VRML, QuickTime VR and video, 
Shockwave, and 3D Animation, 

(BWGTT) Our Price $35.95 




I Guidelines for how 
tooplace Infonnatjon online 
within your company. 

Provides both a design and 
development process and 
a set of guidelines for the Internet, 
intranets, and help systems for designers and authors who need to 
create effective electionic information. Includes CD-ROM with software 
containing tiles to help you utilize the models described in the book. 


Standards For Online 
Communication 

by JoAnn T. Hackos and 
Dawn M. Stevens 


{BSFOQ Our Price $40.45 
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Linux Configuration 
& Installation, 

2nd Edition 

t n c T 1 «« ^>y Volkering, Kevin 

Reichard, and Eric F. Johnson 


Linux, the leading UNIX 
variattt, has garnered 
loads of attention within 
the UNIX cornmunily. The 





HO^ 


amazing thing about 
Linux is that you don’t need a workstation to run it. Linux 
Configuration & Installation. Second Edition lets you run Linux today. 
Program with Linux using C, 0++, Perl, and Tcl/Tk. The 2 CD-ROM 
pack offers one of the most popular Linux distributions, Slackware 96, 
and comes directly from Patrick Volk^ing, the creator of Slackware. 
(BLCI2] Our Price $35.95 
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Web Publisher’s Design 
Guide for Macintosh, 
2nd Edition 

by Mary Jo Fahey 

This is the only book that takes you 
step-by-step through real projects 
designed by talented new media 
^ists. internet design experts share 
their design secrets and art files (look 
for art files on the companion CD-ROM 
by artist’s last name}. This expanded new edition includes 
Photoshop, Illustrator and DeBabelizer tricks from the first edition 
plus countless new ways to liven up your Web pages with 3D 
graphics, sound, movies, and much more. 

(BWPDG2) Our Price $ 35.99 


Getting Hits-The 
Definitive Guide To 
Promoting Your Website 

by Don Sellers 

Getting Hits explains in easy-to- 
understand language the underlying 
concepts behind the art of Web site 
promotion. Just a few of the topics 
you'll learn include: using search 
engines with URL’s; finding related Internet groups or lists; 
understanding the nuances of click throughs and ad rates; and 
distributing press releases to key Internet contacts. With this book, 
you’ll go beyond the conceptual and actually follow real-world tested 
promotional campaign strategies. Bring the world to your Web site! 
(BGHrrS) Our Price $17.95 
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BASIC for the Newton 

by John Schettlno and Liz O'Hara 

Program on Macintosh, Windows-based PC, or on 
the Newton Itself. Straight-forward “programming by 
example" approach - you'll be writing Newton programs right away. 
Includes 3.5" disk containing Demonstration NS BASIC and over fifty 
example programs (Nevrton not included). 

(BNEWT) Our Price $32.35 

SEE RELATED CATEGORY: Dev, Environments 




HTML For The World 
Wide Web, 2nd Edition 

by Elizabeth Castro 

Teach yourself Hypertext Markup 
Language ttie quick and easy way! This 
Visual QuickStart Guide uses pictures 
rather than lengthy explanations. You’ll 
be up and running in no tirne. If you 
need to learn HTML fast - this is book 
is for you. 

(BHTMLWP) Our Price $ 16.15 



Macromedia 
Shockwave for Director 

by Jason Yeaman and 
Victoria Dawson 

The complete resource for creating 
Shockwave movies on the Web, This 
hands-on reference makes it easy to 
create Shockwave movies and put 
them on ttie Web, Expert tips from the 
creators of Macromedia's first 
Shockwave movies, together with detailed examples and instruction, 
provide everything you need to get started. Includes CD-ROM. 
(BMSFD) Our Price $27 



Programmer’s Tooibox 
Assistant CD-ROM 

Instant eleetronic access to 
Inside Macintosh essentials, 
by Addison-Wesley Publishing 

Get quick access to reference pages for over 
4,000 Toolbox calls in your system software 
from their development environment. Essential 
information for Macintosh software developers, Hypertext links allow 
programmers to view related topics easily. The ultimate electronic 
reference tool for Macintosh programmers, 

(STBASST) Our Price $89.95 



Optimizing PowerPC Code: 
Programming the PowerPC 
in Assembiy Language 

by Gary Kacmareik 

Take full advantage of the potential of the 
PowerPC by mastering the Assembly 
Language techniques, Learn to produce 
faster more robust software! 

(BOPTPPC) Our Price $35.96 



This book takes an easy, visual 
approach to teaching JavaScript, 
where pictures guide you through the 
software and show you what to do. 
Works like a reference book, you look 
up what you need and then get straight 
to work. No long winding passages, concise, straightforward 
commentary explains what you need to know. 

(BJWVl/lA/) Our Price $ 16.15 


JavaScript For The 
Worid Wide Web 

by Ted Gesing and 
Jeremy Schneider 
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Programming for the 
Newton Using 
Macintosh:Software 
Development with 
NewtonScript- Second 
Edition 

by Julie McKeehan & Neil Rhodes 


■RO' 


Praise for the Second Edition! "Rewritten from cover to cover, this 
new edition teaches you the essentials of programming for Newton 
2.0. You must read this book. Ttien read it again. And again .. 
SCRIBBLES (OxNUG. Australian Newton Users Group) Includes one 
CD-ROM for Macintosh 68030 or higher. 466 pp. 

(BPFNUM) Our Price $31.45 




Second Edition 

by Dave Mark 


New revised edition! Easy-to- 
understand - everything you 
need to start programming. Updated and 
enhanced exercises that lead you step by step. 
You'll learn function, variables, point datatypes, data structures, file 
input and output and morel Includes CD-ROM with Metrowerks 
CodeWarrior™ Lite. 


Learn C on The Macintosh 


(BLEARNC2) Our Price $33.25 

SEE RELATED CATEGORY: Dev. Environments 


OBJECnVE-C 
Object-Oriented 
Programming Techniques 

by Lewis J. Pinson and Richard S. Wiener 

Presents the basic concepts of object-oriented 
design and programming, and provides a 
precise description of the Objective-C 
language. Several small-to-medium sized applications using 
Objecdive-C illustrate the general principles of object-oriented 
programming. Covers ttie two main versions of the Objective-C 
language. Demonstrates the versatility and power of the NeXT 
machine as a platform to support object-oriented programming. 
Shows how to design, implement and use hierarchies of classes. 
Explains the purpose of pre-defined classes and shows how they 
can be used in designing programs. 

(BOBJCOOPT) Our Price $34.15 



Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 


Metrowerks CodeWarrior 
Programming 

by Dan Parks Sydow 



Includes CodeWarrior Lite, and Full Coverage of PowerPlanP”. The 
best information on Metrowerks CodeWarrior. giving full coverage to 
the Gold Edition. CD includes Code Warrior Lite. 

(BCWPROG) Our Price $35.95 




C++ Programming 
with CodeWarrior 

by Jan L. Harrington 

Beginning OOP for the Macintosh and Power 
Macintosh and Mac OS compatibles. Learn 
object-oriented programming techniques 
using C-i-r as the example language and 
Metrowerks and CodeWarrior as the example 
compiler. Enclosed CD contains example code from the book and a 
full-function Metrowerks CodeWarrior 


(BCPPCW) Our Price $32.35 


CodeWarrior Software 
Developmentusing PowerPlant 

by Jan L Harrington 



C-n- programmers will learn to develop object-oriented software 
applications for Ihe Mac and Power Mac using the PowerPlant 
environment and the classes that support it. Covers CodeWarrior 8. 
Included CD-ROM contains source c-ode for all the programming 
examples in the txxik and Metrowerks CodeWarrior Lite. 

PCWSWDEV) Our Price $31.45 


Inside PowerPlant 

by Metrowerks 

Create Powed^lant applications using the CodeWarrior IDE a^id 
PowerPlant Constructor. Full descriptions of major PowerPlant classes 
and resources. Included are the PowerPlant Constructor Manual, 
including View, TextTraits and Custom Types editing, and PowerPlant 
Library Reference, covering all classes and functions in PowerPlant. 
(BINSPP) Our Price $34.95 
SEE RELATED CATEGORY; Dev. Environment 


Inside CodeWarrior Professional 

by Metrowerks 

Includes CodeWarrior IDE User's Guide. This is the printed version of the 
documentation provided on the CD. Covers CodeWarriw Professionai 
Release, the debugger and associated tools. 

(BINSCWP) Our Price $34.95 

SEE RELATED CATEGORY: Dev. Environment 


AppleScript Finder Guide, English Diaiect 

by Apple Computer, Inc. 

Provides definitions for Rnder object classes and commands. Write, 
record, or run scripts that trigger the same desktop actions that you 
trigger using the keyboard and mouse. 

(BAFG) Our Price $17.95 

SEE RELATED CATEGORY: Scripting 
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AppleScript Language Guide 

by Apple Computer, Inc. 

A complete reference for anyone using AppleScript to modify existing scripts or to 
write new ones. Contains useful information for programmers who are woilting on 
scriptabte applioations or complex scripts. Features detailed definitions of 
AppleScript terminology and syntax in the following categories: Value classes, 
commands, objects and references to objects, expressions, control statements, 
handlers, and script objects. Includes many sample scripts, discusses advanced 
topics such as writing command handlers for script applications, the scope of script 
variables and properties declared at different levels in a script, and inheritance and 
delegation among script objects. 

(BW.G) Our Price $26.95 
SEE RELATED CATEGORY: Scripting 


AppleScript 
Applications: 

Building Applications with 
FaceSpan and AppleScript 

by John Schettino Affiliation & Liz O’Hara 



Build complete AppleScript applications using 
FaceSpan, a user interface development tool 
that mates AppleScript applications truly 
“Mac-Like", Uses a step-by-step approach 
to demonstrate techniques for building 
applications through illustrations and 
samples. Provides Graphical User Interface 
(GUI) design tips and practical approaches for 
implementation. Contains one CD-Rom with 
AppleScript 1.1, a demonstrations version of 
FaceSpan 2.1, source code for all example 
applications numerous AppleScript shareware 
and demonstrations programs. Contains a 
section on debugging AppleScript 
applications using FaceSpan. 

(BAPSCAP) Our Price $31.45 




Special Edition 


USINCi 

CGI 



Using CGI, 

2nd Edition 

by Jeffry Dwight, Michael Erwin 
and Robert Niles 


Vioiiii I'diliun 1,, cjue 


This complete reference provides 
professional Web developers and advanced 
personal users with the latest information 
on using CGI (Common Gateway Interface) to interact with databases. 

• Explains client and server uses of CGI 

• Provides extensive coverage of live audio and video feeds, user 
chat and interaction, and CGI security 

• Features separate chapters devoted to language-specific tips, 
tricks, and traps 

• CD ROM is loaded with the FITML and CGI sample code from 
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Java in a Nutshell, 2nd 
Edition 

by David Flanagan 

A detailed overview of all of the new features 
in Java 1.1, both on a package-by-package 
basis and in terms of overall functionatity, A 
comprehensive tutorial on "inner classes" 
that explains how to use all of the new types 
of inner classes: static member classes, member classes, local 
classes, and anonymous classes. Practical, real-world example 
programs that demonstrate the new features in Java 1.1, including 
object serial'Eation, the new AWT event handling model, 
internationalization, and a sample Java Bean. 

(BJNUT2) Our Price $17.95 


the book 

• includes applications for guest books, mail and new gateways, 
browser identification, access restriction, and shopping carts 
(BSEUCGI) Our Price $44.99 






JavaScript for the Macintosh 

by Matt Shobe and Tim Ritchey 
Allows non-programmers to take advantage 
of the power of Netscape Navigator. Expand 
the capabilities of your Web page, without 
having to understand C or C-t-i-. CD-ROM 
contains “Wizlets" hiat allows you to easily 
create your own JavaScripts. Takes you step- 
by-step through programming cross-platlorm JavaScripts. Details 
how to create JavaScripts for JavaScript-aware Web browsers. 
(BJAVASCRPTJ) Our Price $40.50 
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Teach Yourself Java for 
Macintosh in 21 Days 

by Laura Lemay and Charles L Perkins 
with Timothy Webster 

Add interactivity and multimedia to Web pages! 
A step-by-step guide to make your Website 
come ali\«. Learn the basics of (Kogramming 
Java applets and the concepts behind the Java language. Includes CO- 
ROM with a limited version of Roaster, the first commercial, integrated 
applet development environment for Java for the Macintosh! 
(BJAVAMAC) Our Price $36 

3D Graphics OOU 
Programming 
Using QuickDraw 3D 

by Apple Computer, Inc. 

Incorporate spectacular 3D graphics into 
your applications. Explore QuickDraw 3D, 
a revolutionary graphics extension to the 
Mac OS lor Power Macintoshes. CD 
contains the complete QuickDraw 3D 
system itself and a complete database of the QuickDraw 3D API. 
allowing you instant access to the hundreds of graphics calls via a 
fast viewing engine. Book/CD-ROM, 640 pages. 

(B3DGRAP) Our Price $35.96 



‘D'icksofThe 
Mac Game 
Programming Gurus 

by McComack, Ragnemalm, Celestin, et al. 

For beginning to expert game programmers. 
Complete overview of all the necessary 
components of game programming on the 
Macintosh. Packed with valuable tools, 
utlities. sample code, CodeWarrior^” Lite and game demos. 
QuickDraw 3D and Power Mac optimization and inside info on how 
Glypha III was created. Hundreds of tried-and-true tricks, tips, and 
insider secrets from well-known Mac game programming experts. 
(BTRICKS) Our Price $45 
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Game Programming 

by Kevin Tieskoetter , „ ^ 

Develop your own 3D games in 
C on the Mac. Includes CD with 
project files for both Symantec 
C and Code Warrior. Create 
freeform texture-mapped games and 
polygon graphics. Control dynamic source 
code - all compatible as native to the Power Mac. Write directly to 
the screen, bypassing QuickDraw. 

(BBLACK) Our Price $35.99 
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Check out our Web site! 

• Full product descriptions • Hundreds of more products 

http://www.devdepot.com 




Advanced Color Imaging 
on the Mac OS 

by Appie Computer, Inc. 

Enhance your software's color 
capabilities with step-by-step 
instructions. Augment the color support 
supplied with QuickDraw, and QuickDraw 
GX. Use the Pallette Manager to get the 
best colors on limited displays. Match 
colors between screens and input/output devices (scanners & 
printers). CD includes a complete reference information in both 
QuickView and Acrobat formats. Plus, a sample application 
demonstrating ColorSync programming techniques. 

(BADVCI) OurPnce $33.25 



The Internet 
Marketing Plan 

by Kim M. Bayne 

This book gives you a comprehensive 
framework for producing and executing 
a customized Internet marketing plan. 
Marketing communications veteran Kim 
Bayne supplies you with a clear set of 
step-by-step procedures for 
establishing, implementing, evaluating, 
and managing your Compaq's online 
presence. 

(BTIMP) Our Price $35.99 



Protect Yoiu' Privacy 
on the 

Internet 


Ynt4 Ht tflUltmti 


Protect Your Privacy on 
the Internet 

by Bryan Pfaffenberger 

This book/CD-ROM package gives you 
proven privacy defense strategies and 
techniques to help you make the Net a 
safer place to work and play. You'll get 
the names of Internet privacy 
organizations that are working to 
protect your privacy rights and find out 
what you can do to help. 

(BPYP) Our Price $26.99 


Order Toll-free 


800-MACDEV-1 

!800«22-338l| 
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INSIDE MACINTOSH 



Inside Macintosh; CD-ROM 

by Apple Computer, Inc. 

More than 25 volumes in electronic form. 
Includes: QuickDraw™ GX Library, Macintosh 
Human Interface Guidelines, PowerPC System 
Software, Macintosh Toolbox Essentials and More 
Macintosh Toolbox, QuickTime and QuickTime 
Components. Access over 16,000 pages of 
information with Hypertext linking and extensive 
cross referencing. 

(BIMCD) Our Price $89 


Limited time offer to buy these Inside Macintosh products - 10% off! For full 
product descriptions please see our Web site, or feel free to call, fax, or E-mail us. 


PRODUCT 

CODE 

OUR PRICE 

Inside Macintosh; Devices 

BIMDEV 

26.95 

Inside Macintosh: Files 

BIMFIL 

26.95 

Inside Macintosh; Interapplication Communications 

BIMIAPP 

33.25 

Inside Macintosh: Memory 

BIMMEM 

22.45 

Inside Macintosh: More Macintosh Toolbox 

BIMMAC 

31.45 

Inside Macintosh: Networking 

BIMNET 

26.95 

Inside Macintosh; Overview 

BIMOVER 

22.45 

Inside Macintosh; PowerPC Numerics 

BIMPPCNUM 

26.05 

Inside Macintosh: PowerPC System Software 

8IMPPCSYS 

22.45 

Inside Macintosh: Processes 

6IMPR0C 

20.65 

Inside Macintosh; QuickDraw GX Prop. Overview 

BIMGXOV 

22.45 

Inside Macintosh: QuickDraw GX Typography 

BIMGXTYP 

26.95 

Inside Macintosh: QuickTime 

BIMQT 

26.95 

Inside Macintosh; QuickTime Components 

BIMOTCOM 

31.45 

Inside Macintosh; Sound 

BIMSOUND 

26.95 

Inside Macintosh: X-Reference 

BIMXREF 

17.95 


(Book sale prices are contingent upon availability) 
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for Hacinlosb 
Programmers & Developers 



MAGAZINE 


MacTech*^ Magazine 

MacTech keeps Mac programmers & developers up to date with everything they neer 
know about software development. Topics like Rhapsody, Java, QuickTime, OPENSTEI 
Objective-C, C/C++, Object Oriented Technologies, product reviews and much more! 

Subscriptions; 

(MTYRDM) US/Domestic for 12 issues $47 
(MTYRCM) Canadian for 12 issues $59 
(MTYRFM) International for 12 issues $97 
Back issues: each plus shipping (subject to availability) $10 

MacTech*^ CD-ROM Volumes 1-12 

• Includes Apple’s issues 1-29 (1990-1997) 

• Almost 1600 articles from all 139 issues of MacTech 
Magazine (1984-1996) and through may of 1997 

• Improved hypertext, improved indices, and a new THINK Reference Viewer- 
for lightning quick access! 

• New hyperlinks between articles 

• 100+ MB of source code—use them In your applications, with no royalties! 

• Full version ol THINK Reference™—the original online guide to Inside Macintosh, Vols. 1-VI 

• 80MB of FrameWorks/SFA archives and the most complete set of FrameWorks archives known 

• SprockeH”! MacTech's tiny framework that compiles quickly and supports System 7.5 features 

• The best threads from the Macintosh programmer newsgroups plus thousands of notes, tips, 
snippets, and gotchas 

• Popular tools that Macintosh programmers use to increase their 
productivity and much more! 

(SMTCD12) Volumes M2 Our Price $129 
(SMTCD12LI) Upgrade from any previous version Our Price $49 
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Here are more products. For full product descriptions please see our 
Web site, or feel free to call, fax, or E-mail us. Our prices on books are at 
least 10% off list price. 


PRODUCT 

DevelDprT>en( Environments 

CODE 

PRICE 

ARiieSfaipt A^ipJicaiiCttS: DuHIfiv Applicalians .... 

lor itie Mewtcn * i^mgraminno tjsing NS . 

....imCAP_ 

$31.45 

.Bftwr. 

32J5 

r.4-4-FVnfparaTin^] _,, , 

.RCPPMACAP. 

.,31.46 

,,,,,, ,,,,, 


.. --,32,3& 

HVC tlRS^ 

... 

. SCmjSEH. 

. 26 .00 

Cod^Mamcr PoiwfPiard...... 


.34 J5 

rjvii'W-irTUT using PnuHfPbfit _ 

F¥™KlinFV 

.31.45 

.34-95 

rvogrammefs Kli... ... 

.BCVBeRDOG .. 

Pra»iri^ Ovt Ptiwnr of Pmgrapli rJX.^. 

HfWMPflrt. 

.16.95 

Iiiskic CfflkjWiirrior Popk... .. ... 



liKlFint nrwRA ..,,... 

nq 

17.96 

Last ttesfHt l^namrners bdlUOfV..... 

... JLSTRSflT..-_ 

74.65 

1 ftpm r qn ftw Msrtntri^ Ffflitirtti .,,.. 

... RirAfiMng.,.,,,,. 


leawiCi 1 m ttw Mscinltttft........ 
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..H.ae 
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._ BCARO. 
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31.45 
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_26.95 
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HF^IF 

22.45 
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mmi ... . 
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.. 26J6 

hretent Internet Gijidqj . ..................................... 
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...13.45 

mierne* Book..... ...... 
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17,90 
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..,.36,00 
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.. .BJAVAESSffl.. 

......17.95 

Java Ifi a Hutstveil....,... . 
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.. 53.99 

Java Prtjgramrtving wllh OOr^iA....... .. .... 
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.26.99 
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^ ajAVASCRPT 

40.50 
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.....BLHTML. 

.36.95 
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.17,96 
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.BNElCHAr..... 

17,00 
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.....45.00 

ttel'a'aif* HO . 

.BNETN3.. 

.26.96 
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..,,,31.49 
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.....17.99 
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.3146 
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.31.46 
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leachiltoiJfasEf Java In 21 days..... .. ... ...... ..... 
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.BUMP. 

36.99 
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.BUMDEH..... 

.22.4S 
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„.„BULN. 

.40.45 

Wteh Man fifilrlR ,, , , . , . . 

HlWFHJHFAll 

27,45 

Wlt!h Piigo finding Trsiiriifpjcs. ... .. ... 

..8WEBPST. 

... 46.00 

VWatiPubfediiny wWi AdotM Aorohal and PDF____ 

gWPWM . 

3S.9S 

Wed Wflaving.... .. ..... ... 

.0WWEAV... 

.22.45 

VMimflsler MaointoBh ... .- ..... 

awEBMAS. 

3Gl95 

Scripting and Solutions 

AtHileScfipfl AjifJlicatiMUi: BuiWkig Ajp; wilfk FEitsStKin. .. . 

.ElAPSCAP. 

.31.45 

7^lfl!*r^ Scfiptmg Aiiriillnns (ijlfte _ ___ 

.BSCrtADO.... 
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Appllfifl Mw^trlnflii Kcilgting , 

.BAIWED... 

.3145 

h-^pnifjirTi 3.3 liarirlljnflli.. . _____ _,. 
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...31.50 

Conapteie HypefTatk 2.2:.. . ..... ... 
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.. .DHVPCRD2... 
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.3150 

.31.46 

h^poCdrd Stack Dtjs^n.... 

.BHVPSTA ... 

...,.19.9& 

..IsufiSniifiJ Int Marinirwh.. _ . 

.....HJAyASCRPT.. ........ 

.40.50 

Perl (lulok fteieronce.... ...... 


.17.90 

ReatWnrldAmle Guide. ... __ _ 

.... 
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Technical Reference 

Actruc Java.............. ..... 

.BACTJAVA.. 

.23.36 


Apii*e CD-ROM Haftdhook.. 

Art ot Human Inlsitace 


Black Art of Mac Gsmo Pmgrainmifig.. 

C^ I krt DwmuiiS!.... 

Ctor 1... 


Devetaping Obfsct OrientEd Soltwara ftor tve Madntoah ^ 


nnraiAMD.. 
...BAtflD........ 

...eBLACK. 

...BCPPntlW.. 
...BCOJM...... 

...Boeras. 


..UM 

,29.65 

...35.99 

22.46 

...17.95 

26.06 


Fo(jiidatkirifl nf Mapiiilr^di PmgraiTm .,,. 


...^tW)-. ........... 

.35.96 

Fragment cil Yojr Imaginalron... ......._ 


.. . ...ei-KAG .. 

35.96 

Guide to ^teciiitosh SoO^waru Locaili74iiiud. 


Ri nrju 17 

.24.26 

Guide to Macintosh System 7.5.. 


..DSY57.5 ........ 

..22.50 


toswe me Macintosh ComfinL.jnicatK)ns looioox... 


Hnnuui 

.22,45 

1 isKRfWriter Eteffimnne_____ 


.BLASER80^...™„. 

,,.17,96 

1 1*^11 ri Cj-e- nfI Ute M:irinli1>dl 


ill flMTPP 

36.0(5 

Leari Cmtlie Macintosh. IslErSiofii.,. ..... ., . 


.BLEAUNCT... 

..31.45 

Uam C on the MocieiJCisti. 2ncl Editioh. 


.aEAflMC2..., H,. 

33,25 

Mnr‘PfmjiniiitiiitKj Itw riijrruiiii«: ______ 


.„....BMAGmjM .. 

...17.95 

Macantesti C Programmsr Piintor t.. 


.BCPfflMI. 

24J25 

MacuTtesd C PJogrammer HrmsT Uoluiiie 2. „„ ...._ 


.BCPF«M2. 

.24,25 

Macintostr OL^ Prog, ftdef^joe Wofkiraj wilti Objects. 


.J101F7. 

40.45 

Maantosti Pasta! Prooramnilng Prlmaf Vloteine 1................... 


.BPASCPTtt.. . 

24,25 

Maarrtiosfi Programimrig SeenstsBd sdllkjn .. 


.BP3ECFiET.„„. 

28.76 

Mflitintub'h ProQiainniitiy Toctuiiquei;.. 


....BPTFCH. 

31.95 

Mbrr^ft VKuafl J+ r 1.1 SdufcOllOa!^.,.... 



...35.95 

Mfwe Mar Pmyramin|n(] Twdifiiq^iijfi. 


.. 

BMOfirltOH 

34.5U 

Nctwark Frontier BmidlG .. .. . 


.BWTO .. .. 

50.35 

Wfimrtwi Pr^QiaFiitminy Giitoe_... 


.JMWTPGiflD . 

.. 40.46 

rHijeifTt fkiftniHfl litn^ranvnMVf lltetign 


..B0DPH01*S.... 

29.66 

nfiliminnij Pn^wfvPC (^4^5.,.,. 


..80PTPPC.. 

35,96 

Pfld Oiildk RRleranra)...... 


...BPEfiLREF.. 

„ 17.99 

IVftfKrupl 1 Anqnage ttaterenijR 


.BPSUWtF. 

29.66 

Pcwrertiook: Dlgjlal Momad's Guide...... 


.JPETDNG. 

22.46 

PtiwHtPC PTograrruTiH’sTiiclkil.... 



40.50 

Pnogrammilng Ihtroductkin to the Macintosh Faniily....._..._ 


.J3FAM1LY. 

2Z.46 

Programming for System / 


.BSV1S7. 

.24.26 

Progfainminy Pfimw MaddlnshVtiiimB 1..... 


.DPffiMMAn. 

...34.15 

PfOgraramlng Starter Kit....... 


HPttnSlAHI 

...40.50 

Pfiigramming wtth AppteTal ...... 


RpnrtAT 

...22,45 

QuickTime ■ OirrSal Guktefoi MacirHi’j.'jti Users.,,,,,,-,,,,,,.,,,,., 


ROmRIIIW 

J6fn 

np_flr uuinrifl Appte Rjjlfta . _,—___- 


....HTEAiWLD... 

,..35.95 

Kesfcdit All Night Diner............ 


.BRESDINE. 

.22,45 

ResfidH Comptete, 2nd Eciticm.. .. 


..BFlESFD?... 

...31,45 

IteRFdlt Reterftnce....,.. ..................... 


.BBEJjtDnEE. 

..28,06 

Software by Ueslgri. Creating User Friendly Software. 


..BDE5IGN,,,,.. 

26,95 

Syimantoc C-h- for the Madrlosti' The Basics,,..,.......... 


..SSCFTMTB. 
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Teach Ydufsalf Macintrisii G^ 4 in 21 Days,..... 


.^......ECPP21D.. 

.28,99 

TecJhnlcal IhtfodudKifi to the Macintosh Family..... 


. .^BlTTTlif. 

.. Z4.Z6 

Tog ohSollWBra Design ......... 


..htog... 

,..,26,96 

Witete^ lor iha Newton Devetogment lor Mobi Gomm_... 


..„QWR£LESS.,... 

,...31.46 

Writinfi Focafeabla Sodlviare.... 


.SLOCAL . . 

..3426 

Miscellaneous 

3D Graphics-Tips, Trichs. S Tachnkjties. 


.BSUGITT,,,,,.. 

...3146 

A Fragment of \ixir Imagmatlon..... .. 


.BfHAG.... 

...35,96 

Artolto PremiBTe lur Ilia Macimui^i.... 


RPBTM 

...44.95 

Ajinerica Online terOummies........ 


..........BftOUXJW.. 

17.95 

AppteGuidfi Compieto... .. 


.BARGO.... 

.35,96 

Art tif Fkiman InlalDOJ Drjslgfi.......,,, 


.UAHC .. 

zaes 

CD-ROM Glide to Miillmiedia Aulhoring... 


.BCOMiTt... 

.40.45 

CompuServe lor Dummies... 


.BCSDUM. 

.,,.1195 

Creating interacttve CD-ROM... 


__ BINTBtCDfl ... 

... 35,95 

Cyhfifpijnk Hanittififik..... 


IVIVFlPIlMf 

.6,95 

Damy Coodmari's Apple CiikJa Steder KM.. 


..BOGAGSK... 

.3146 

Uanriy GoodmaiTs Macintosh Hsfictoook ...... 


..BGOODHB ... 

26J95 

FiaimiWbrks SduceCwie ..... 


.MTTViSC ... 

.9^ 

TrameWtirks Magazine Back Issue .... 


.MTFWBACK . 

.. ,6.00 

Gilobai Interface Desigfi ..... 


.BaOBAl,,,,,,,. 

.32,35 

Graptm: Ccrrei 3 . . . . . 


BfiFMca 

44,95 

Q^apWe Gflnis 4 .... 


.. BGEME4 .. . 

..44J15 

Graphic CemsV ..... 


BGEMS6 . 

.44,95 

lirtiru n RnvnviliEfl . 


...BttffTlfiFV ... 

, ,,.40.50 

liEsifta Difpptnr 5 urith 1 ingn inr MarJnlrKh __ 


, .DID5WLM.. .... 

.„44.d9 

Late Night wilh Maef^ck ___ 


HI Atl- 

28,95 

Mac Balhfoom Raader..... 


BBATH.... 

,11,70 

M3i;rtirriartto QirecJor 1 irge Wfirkshop, 2iir) Fdilioo... 


..JMDtW2__ 

...40.50 

Mac Scr^mer: fhe LJItimate Macintosh Superchafging KM,.... 


.tJSOfEAM ... 

...31.50 

Macintosh Crash Course.-... 


.BCftASH.... 

,26.95 

MncTiiidi Bati; ,.,,..,,... 


. MmAGKiSS .. 

...10.00 

Ma™nfSri t Rtlmaln Mscirrtnsh Pragramming Rcmlr. 


_BULTMAC . „ 

.35,95 

Managiiiq AppleShare & Wnntijroup Servers .. 


. BMAWS.. 

28.96 

ManArnw qtmnniu 


SMAOAS3 

,..9.96 

Miritlmedia Authoring: Gullding and Dev^ing Doenmems.... 
Multimfldia Slarter Kit tar Mactatosh. ... 


...........BWWAtrm 

_BMMSIAHI 

.3145 

27,00 

NctwoiK Frtirlicrs Btpridip . . . .. 


.RNETFa ... 

.59.96 

Pidlil hmi FitpEaiaice;,,,......,, ..... 


. ....... UPROFTT . 

.. .22.45 

Itesbdit COmpfetB, Second btfrtion ... 


. .BlttStDZ .. 

,,.3145 

Sad Macs. BmiDs and Disaslers ... 


...... .BSADMAC . 

...22.45 

Stupe! Mac TilitK .. ... 


. USTURDMAG. 


TTie Elanertto of E-Mall Styte ..... 


.. .JEMAl . 

,.t3.45 

1 he Softwaa Ltevstopef 's & Marketer s L^l Cornpanton . 


..liSOAMLC . 

.33.26 

Trig rsn RnlNiqir;’ rir!si(p . .... 


.jiroG . 

26.95 

Tricks of Ihe Mac Game Gums ..... 


...BTRaCKS.. . 

...45.00 

Zen aixi the Ail of ftesoorce EcUUio... 


... 

..,27.00 
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All entries in this index are alphabetized, For your convenience the product names 
are bold, book names are italicized and company names are in plain text. 


1000 Games for Macintosh ....17 

3D Gmphics ProgrBfTvr^ ......... 27 
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BAS^G for the Afovt^ofT........ 24 

BBEdIt 4.0.4.....-_...____12 

BeachV\fefie, Inc,,............11,18,17 

BealWare, Inc, ..................7 

Biadf M of MaeJntosh Gams Pmgmmrmg........ .27 

Bowers Development.,.....*..*..............,8 

Bungle SollWtffO.........*.*...17 



C’l + Pmgrsmrrmg with CoafeVfenror...........25 

C’tree Plus0 Database Handler........_________.6 

Capilano GofTpjtif ig .................... 10 

Gaptivade 4.6: Essential Graphics Utilities.__________ 16 

Casino!.........,.............. .17 

Ceteslh Company.__ _________________.J 

CGi Toolkit..13 

Classic Arcade____ .,....,17 

CodeBuilder.... ...—........,.S, 9 

CodeManager 4. .......„.„2 

CodeWarrior for BeOS 3,...,.....-.. 2 

CodeWarrior for Palm Pilot ......._„._2 

CodeWanlor Latitude........„„2 

CodeWarrior Professional Release--- 

CDCfeltemor Sokwafe Devdopmmi Using PtMOrPtOfiL.... ...... 25 

GodeWanior Wear ______—19 

Compnelt!________10 

ConiJt Graphics...............10 

CPU Doubler.. io 


D'OLf Oev GtJw^e................ 20 

Debugging Madntosh Senate witfi JVtoiJbg..........................................................21 

Oe&QtwiQ 3D Gfapi^.. ............ 22 

OevBfophg OT Rsri............*. ...22 

Coital Technologv International................14 

Digitool, Inc..............4 


Discover Programming for Macintosh.......___..3 

Discover Programming with Java......-.3 

Disaomhng OF&^WP. Mac ............—.....,,.20 
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insfde Macintosh: QuickTime Compments..... ... 

fosfcfe Macintosh: Sound ....... 

inside Macinto^: Text. ...... 

inside Macintosh: X-Ffd&enca ........ 

inskki PawerPtant. ........... 


.2T 

..25 

..28 

..23 

.......23 

.......28 

.......28 

.28 

. ..26 

.......28 

. .28 

..28 

.2a 

.,23 

. 28 

.......28 

. .28 

.28 

. 28 

.......26 

.28 

.26 

.......28 

. 28 

..28 

. .28 

. .28 

. 25 


Java ki a Nutshdl, 2nd BUlion ............ 26 

JavaSerpt 1.1 Doveiopeds Gdde,.. .......28 

JavaSorbt. CorJbock.. .......,............21 

JavaScript for foe TWbcfofos/t.. ...........26 

JavaScript For The WWW Wick: Web .........24 

JavaScript Netscape Wizardry ..................................................... ..... .,..23 


Lakewood So1tware..,.„...—.......11 


Web site: http://www.devdepot.com • E-mail: orders@devdepot.com 


31 




























































































































































Liste Sottware Lid............14 

Ls^Con JhB MsdntD!^h Secofiii BMttn....... ___.25 

iinuif S instaHation, PfKi Fditkx} ....... ,....23 
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WebStplion allnvyg,yoLi to rapidly Resign custom 
server-side web applications'by embedding 
an easy to learn, yet pQwoi'lul scripting ' 
language directly into your HTML documentSli 
WebSiphon also includes Verona, the only 
Macintosh flat-file database server written > 
specifically for use on a web site, ff you havf" 
ever felt restricted by other web site, 
development products bn the market, then 
this is the tool lor you. 


— PowerPC” Native 
^ Muitkhreaded 
— Compiled Language 
Caching 




r d em o& 
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'wEbSerfcinel 


WebSentinel replaces or supplements your 
web server's built-in security, allowing rbore 
fleyibilitV and power to manage users and 
secure areas witli a complete Macintosh user 
interface. Features include 6REP match 
strings, custom “No Access’" files for each 
realm, and full caching. WebSentinel’s plug¬ 
in architecture allowS’you to integrate with 
^ur existing user data and security 
*^httectures. ' 


1016 mopac circle, suite 101 
austin lx 78746 
phone 512.328.2288 
fax 512.328.2688 
info® purity com ^ 
































d^l997 Metiwerks Coiporatlon. All righte rese{^d,^^3 


Wh.en Rhapsody gets here, 


.you'll be ready...wl 
'•tJodeWarrlor Latitude 


It's Metronerks' newest 


^ porting tool, designed to 

i- 

glve you a leg up on 
Rhapsody, Recompile your 
Kac OS source code, link It 


with the Latitude libraries 


and find out which portions 
of your code are going to 
port smoothly... and which 
won't Cforewarned Is fore¬ 
armed]. As Rhapsody evolves, 
so will Latitude; registered 
users will receive all 


first full release 


one additional update 


OodeWarrior Latitude 


The tools you need...and 
a’ little attitude to boot 


metrowerks 


WWW 
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